From 788bfffb1e01320f94fc1d395c6fb65ef12e50fd Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Thu, 31 Mar 2022 13:51:00 -0700 Subject: [PATCH 01/17] feat(all): auto-regenerate discovery clients (#1496) --- admin/directory/v1/admin-api.json | 4 +- admin/directory/v1/admin-gen.go | 3 +- bigquery/v2/bigquery-api.json | 7 +- bigquery/v2/bigquery-gen.go | 4 + .../v1/bigqueryreservation-api.json | 37 +- .../v1/bigqueryreservation-gen.go | 161 +++++ chromeuxreport/v1/chromeuxreport-api.json | 4 +- chromeuxreport/v1/chromeuxreport-gen.go | 3 +- cloudkms/v1/cloudkms-api.json | 6 +- cloudkms/v1/cloudkms-gen.go | 15 +- compute/v0.alpha/compute-api.json | 88 ++- compute/v0.alpha/compute-gen.go | 177 +++++- dialogflow/v2/dialogflow-api.json | 6 +- dialogflow/v2/dialogflow-gen.go | 12 +- dialogflow/v2beta1/dialogflow-api.json | 6 +- dialogflow/v2beta1/dialogflow-gen.go | 12 +- dialogflow/v3/dialogflow-api.json | 22 +- dialogflow/v3/dialogflow-gen.go | 25 +- dialogflow/v3beta1/dialogflow-api.json | 22 +- dialogflow/v3beta1/dialogflow-gen.go | 25 +- .../v1beta/firebasedatabase-api.json | 7 +- .../v1beta/firebasedatabase-gen.go | 12 + homegraph/v1/homegraph-api.json | 4 +- homegraph/v1/homegraph-gen.go | 3 +- ondemandscanning/v1/ondemandscanning-api.json | 4 +- ondemandscanning/v1/ondemandscanning-gen.go | 3 +- .../v1beta1/ondemandscanning-api.json | 4 +- .../v1beta1/ondemandscanning-gen.go | 3 +- osconfig/v1/osconfig-api.json | 4 +- osconfig/v1/osconfig-gen.go | 3 +- osconfig/v1alpha/osconfig-api.json | 4 +- osconfig/v1alpha/osconfig-gen.go | 3 +- osconfig/v1beta/osconfig-api.json | 4 +- osconfig/v1beta/osconfig-gen.go | 3 +- retail/v2/retail-api.json | 208 +++++- retail/v2/retail-gen.go | 593 +++++++++++++++-- retail/v2alpha/retail-api.json | 85 ++- retail/v2alpha/retail-gen.go | 155 +++-- retail/v2beta/retail-api.json | 210 +++++- retail/v2beta/retail-gen.go | 596 ++++++++++++++++-- storage/v1/storage-api.json | 17 +- storage/v1/storage-gen.go | 34 - testing/v1/testing-api.json | 4 +- testing/v1/testing-gen.go | 2 +- vmmigration/v1/vmmigration-api.json | 16 +- vmmigration/v1/vmmigration-gen.go | 9 +- 46 files changed, 2287 insertions(+), 342 deletions(-) diff --git a/admin/directory/v1/admin-api.json b/admin/directory/v1/admin-api.json index ac6de59b1a2..ccc5ec7fb9c 100644 --- a/admin/directory/v1/admin-api.json +++ b/admin/directory/v1/admin-api.json @@ -4407,7 +4407,7 @@ } } }, - "revision": "20220208", + "revision": "20220325", "rootUrl": "https://admin.googleapis.com/", "schemas": { "Alias": { @@ -5761,7 +5761,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/admin/directory/v1/admin-gen.go b/admin/directory/v1/admin-gen.go index 8aca1ea20a3..0860a3383c1 100644 --- a/admin/directory/v1/admin-gen.go +++ b/admin/directory/v1/admin-gen.go @@ -2714,8 +2714,7 @@ func (s *Domains2) 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. diff --git a/bigquery/v2/bigquery-api.json b/bigquery/v2/bigquery-api.json index d4b7deb074f..e5765123bc7 100644 --- a/bigquery/v2/bigquery-api.json +++ b/bigquery/v2/bigquery-api.json @@ -1693,7 +1693,7 @@ } } }, - "revision": "20220313", + "revision": "20220322", "rootUrl": "https://bigquery.googleapis.com/", "schemas": { "AggregateClassificationMetrics": { @@ -2811,6 +2811,11 @@ "description": "The geographic location where the dataset should reside. The default value is US. See details at https://cloud.google.com/bigquery/docs/locations.", "type": "string" }, + "maxTimeTravelHours": { + "description": "[Optional] Number of hours for the max time travel for all tables in the dataset.", + "format": "int64", + "type": "string" + }, "satisfiesPZS": { "description": "[Output-only] Reserved for future use.", "type": "boolean" diff --git a/bigquery/v2/bigquery-gen.go b/bigquery/v2/bigquery-gen.go index 710e6ae286d..8b8a650133e 100644 --- a/bigquery/v2/bigquery-gen.go +++ b/bigquery/v2/bigquery-gen.go @@ -2127,6 +2127,10 @@ type Dataset struct { // https://cloud.google.com/bigquery/docs/locations. Location string `json:"location,omitempty"` + // MaxTimeTravelHours: [Optional] Number of hours for the max time + // travel for all tables in the dataset. + MaxTimeTravelHours int64 `json:"maxTimeTravelHours,omitempty,string"` + // SatisfiesPZS: [Output-only] Reserved for future use. SatisfiesPZS bool `json:"satisfiesPZS,omitempty"` diff --git a/bigqueryreservation/v1/bigqueryreservation-api.json b/bigqueryreservation/v1/bigqueryreservation-api.json index e1921e0e83e..ef0c49286b9 100644 --- a/bigqueryreservation/v1/bigqueryreservation-api.json +++ b/bigqueryreservation/v1/bigqueryreservation-api.json @@ -778,6 +778,41 @@ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] + }, + "patch": { + "description": "Updates an existing assignment. Only the `priority` field can be updated.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/reservations/{reservationsId}/assignments/{assignmentsId}", + "httpMethod": "PATCH", + "id": "bigqueryreservation.projects.locations.reservations.assignments.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. Name of the resource. E.g.: `projects/myproject/locations/US/reservations/team1-prod/assignments/123`. For the assignment id, it must only contain lower case alphanumeric characters or dashes and the max length is 64 characters.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/reservations/[^/]+/assignments/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Standard field mask for the set of fields to be updated.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "Assignment" + }, + "response": { + "$ref": "Assignment" + }, + "scopes": [ + "https://www.googleapis.com/auth/bigquery", + "https://www.googleapis.com/auth/cloud-platform" + ] } } } @@ -788,7 +823,7 @@ } } }, - "revision": "20220319", + "revision": "20220326", "rootUrl": "https://bigqueryreservation.googleapis.com/", "schemas": { "Assignment": { diff --git a/bigqueryreservation/v1/bigqueryreservation-gen.go b/bigqueryreservation/v1/bigqueryreservation-gen.go index 4cf7405ba37..000f067b982 100644 --- a/bigqueryreservation/v1/bigqueryreservation-gen.go +++ b/bigqueryreservation/v1/bigqueryreservation-gen.go @@ -4236,3 +4236,164 @@ func (c *ProjectsLocationsReservationsAssignmentsMoveCall) Do(opts ...googleapi. // } } + +// method id "bigqueryreservation.projects.locations.reservations.assignments.patch": + +type ProjectsLocationsReservationsAssignmentsPatchCall struct { + s *Service + name string + assignment *Assignment + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates an existing assignment. Only the `priority` field can +// be updated. +// +// - name: Output only. Name of the resource. E.g.: +// `projects/myproject/locations/US/reservations/team1-prod/assignments +// /123`. For the assignment id, it must only contain lower case +// alphanumeric characters or dashes and the max length is 64 +// characters. +func (r *ProjectsLocationsReservationsAssignmentsService) Patch(name string, assignment *Assignment) *ProjectsLocationsReservationsAssignmentsPatchCall { + c := &ProjectsLocationsReservationsAssignmentsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.assignment = assignment + return c +} + +// UpdateMask sets the optional parameter "updateMask": Standard field +// mask for the set of fields to be updated. +func (c *ProjectsLocationsReservationsAssignmentsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsReservationsAssignmentsPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsReservationsAssignmentsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsReservationsAssignmentsPatchCall { + 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 *ProjectsLocationsReservationsAssignmentsPatchCall) Context(ctx context.Context) *ProjectsLocationsReservationsAssignmentsPatchCall { + 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 *ProjectsLocationsReservationsAssignmentsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsReservationsAssignmentsPatchCall) 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.assignment) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "bigqueryreservation.projects.locations.reservations.assignments.patch" call. +// Exactly one of *Assignment or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Assignment.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 *ProjectsLocationsReservationsAssignmentsPatchCall) Do(opts ...googleapi.CallOption) (*Assignment, 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 := &Assignment{ + 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 an existing assignment. Only the `priority` field can be updated.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/reservations/{reservationsId}/assignments/{assignmentsId}", + // "httpMethod": "PATCH", + // "id": "bigqueryreservation.projects.locations.reservations.assignments.patch", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Output only. Name of the resource. E.g.: `projects/myproject/locations/US/reservations/team1-prod/assignments/123`. For the assignment id, it must only contain lower case alphanumeric characters or dashes and the max length is 64 characters.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/reservations/[^/]+/assignments/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "Standard field mask for the set of fields to be updated.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "request": { + // "$ref": "Assignment" + // }, + // "response": { + // "$ref": "Assignment" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/bigquery", + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} diff --git a/chromeuxreport/v1/chromeuxreport-api.json b/chromeuxreport/v1/chromeuxreport-api.json index 3900b472556..e8451f7340a 100644 --- a/chromeuxreport/v1/chromeuxreport-api.json +++ b/chromeuxreport/v1/chromeuxreport-api.json @@ -116,7 +116,7 @@ } } }, - "revision": "20210602", + "revision": "20220329", "rootUrl": "https://chromeuxreport.googleapis.com/", "schemas": { "Bin": { @@ -228,7 +228,7 @@ "type": "string" }, "metrics": { - "description": "The metrics that should be included in the response. If none are specified then any metrics found will be returned. Allowed values: [\"first_contentful_paint\", \"first_input_delay\", \"largest_contentful_paint\", \"cumulative_layout_shift\", \"experimental_uncapped_cumulative_layout_shift\"]", + "description": "The metrics that should be included in the response. If none are specified then any metrics found will be returned. Allowed values: [\"first_contentful_paint\", \"first_input_delay\", \"largest_contentful_paint\", \"cumulative_layout_shift\"]", "items": { "type": "string" }, diff --git a/chromeuxreport/v1/chromeuxreport-gen.go b/chromeuxreport/v1/chromeuxreport-gen.go index 533b0f7702e..c2cce416e92 100644 --- a/chromeuxreport/v1/chromeuxreport-gen.go +++ b/chromeuxreport/v1/chromeuxreport-gen.go @@ -353,8 +353,7 @@ type QueryRequest struct { // Metrics: The metrics that should be included in the response. If none // are specified then any metrics found will be returned. Allowed // values: ["first_contentful_paint", "first_input_delay", - // "largest_contentful_paint", "cumulative_layout_shift", - // "experimental_uncapped_cumulative_layout_shift"] + // "largest_contentful_paint", "cumulative_layout_shift"] Metrics []string `json:"metrics,omitempty"` // Origin: The url pattern "origin" refers to a url pattern that is the diff --git a/cloudkms/v1/cloudkms-api.json b/cloudkms/v1/cloudkms-api.json index aa3fb149d2e..5cd9610bdde 100644 --- a/cloudkms/v1/cloudkms-api.json +++ b/cloudkms/v1/cloudkms-api.json @@ -1582,7 +1582,7 @@ } } }, - "revision": "20220211", + "revision": "20220325", "rootUrl": "https://cloudkms.googleapis.com/", "schemas": { "AsymmetricDecryptRequest": { @@ -2323,7 +2323,7 @@ "id": "EncryptRequest", "properties": { "additionalAuthenticatedData": { - "description": "Optional. Optional data that, if specified, must also be provided during decryption through DecryptRequest.additional_authenticated_data. The maximum size depends on the key version's protection_level. For SOFTWARE keys, the AAD must be no larger than 64KiB. For HSM keys, the combined length of the plaintext and additional_authenticated_data fields must be no larger than 8KiB.", + "description": "Optional. Optional data that, if specified, must also be provided during decryption through DecryptRequest.additional_authenticated_data. The maximum size depends on the key version's protection_level. For SOFTWARE, EXTERNAL, and EXTERNAL_VPC keys the AAD must be no larger than 64KiB. For HSM keys, the combined length of the plaintext and additional_authenticated_data fields must be no larger than 8KiB.", "format": "byte", "type": "string" }, @@ -2333,7 +2333,7 @@ "type": "string" }, "plaintext": { - "description": "Required. The data to encrypt. Must be no larger than 64KiB. The maximum size depends on the key version's protection_level. For SOFTWARE keys, the plaintext must be no larger than 64KiB. For HSM keys, the combined length of the plaintext and additional_authenticated_data fields must be no larger than 8KiB.", + "description": "Required. The data to encrypt. Must be no larger than 64KiB. The maximum size depends on the key version's protection_level. For SOFTWARE, EXTERNAL, and EXTERNAL_VPC keys, the plaintext must be no larger than 64KiB. For HSM keys, the combined length of the plaintext and additional_authenticated_data fields must be no larger than 8KiB.", "format": "byte", "type": "string" }, diff --git a/cloudkms/v1/cloudkms-gen.go b/cloudkms/v1/cloudkms-gen.go index 1c5851b17f3..6cb593d95f5 100644 --- a/cloudkms/v1/cloudkms-gen.go +++ b/cloudkms/v1/cloudkms-gen.go @@ -1386,10 +1386,10 @@ type EncryptRequest struct { // AdditionalAuthenticatedData: Optional. Optional data that, if // specified, must also be provided during decryption through // DecryptRequest.additional_authenticated_data. The maximum size - // depends on the key version's protection_level. For SOFTWARE keys, the - // AAD must be no larger than 64KiB. For HSM keys, the combined length - // of the plaintext and additional_authenticated_data fields must be no - // larger than 8KiB. + // depends on the key version's protection_level. For SOFTWARE, + // EXTERNAL, and EXTERNAL_VPC keys the AAD must be no larger than 64KiB. + // For HSM keys, the combined length of the plaintext and + // additional_authenticated_data fields must be no larger than 8KiB. AdditionalAuthenticatedData string `json:"additionalAuthenticatedData,omitempty"` // AdditionalAuthenticatedDataCrc32c: Optional. An optional CRC32C @@ -1411,9 +1411,10 @@ type EncryptRequest struct { // Plaintext: Required. The data to encrypt. Must be no larger than // 64KiB. The maximum size depends on the key version's - // protection_level. For SOFTWARE keys, the plaintext must be no larger - // than 64KiB. For HSM keys, the combined length of the plaintext and - // additional_authenticated_data fields must be no larger than 8KiB. + // protection_level. For SOFTWARE, EXTERNAL, and EXTERNAL_VPC keys, the + // plaintext must be no larger than 64KiB. For HSM keys, the combined + // length of the plaintext and additional_authenticated_data fields must + // be no larger than 8KiB. Plaintext string `json:"plaintext,omitempty"` // PlaintextCrc32c: Optional. An optional CRC32C checksum of the diff --git a/compute/v0.alpha/compute-api.json b/compute/v0.alpha/compute-api.json index e8359f723b0..70830187510 100644 --- a/compute/v0.alpha/compute-api.json +++ b/compute/v0.alpha/compute-api.json @@ -38660,7 +38660,7 @@ } } }, - "revision": "20220315", + "revision": "20220322", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -41436,6 +41436,13 @@ ], "type": "string" }, + "localityLbPolicies": { + "description": "A list of locality load balancing policies to be used in order of preference. Either the policy or the customPolicy field should be set. Overrides any value set in the localityLbPolicy field. localityLbPolicies is only supported when the BackendService is referenced by a URL Map that is referenced by a target gRPC proxy that has the validateForProxyless field set to true.", + "items": { + "$ref": "BackendServiceLocalityLoadBalancingPolicyConfig" + }, + "type": "array" + }, "localityLbPolicy": { "description": "The load balancing algorithm used within the scope of the locality. The possible values are: - ROUND_ROBIN: This is a simple policy in which each healthy backend is selected in round robin order. This is the default. - LEAST_REQUEST: An O(1) algorithm which selects two random healthy hosts and picks the host which has fewer active requests. - RING_HASH: The ring/modulo hash load balancer implements consistent hashing to backends. The algorithm has the property that the addition/removal of a host from a set of N hosts only affects 1/N of the requests. - RANDOM: The load balancer selects a random healthy host. - ORIGINAL_DESTINATION: Backend host is selected based on the client connection metadata, i.e., connections are opened to the same address as the destination address of the incoming connection before the connection was redirected to the load balancer. - MAGLEV: used as a drop in replacement for the ring hash load balancer. Maglev is not as stable as ring hash but has faster table lookup build times and host selection times. For more information about Maglev, see https://ai.google/research/pubs/pub44824 This field is applicable to either: - A regional backend service with the service_protocol set to HTTP, HTTPS, or HTTP2, and load_balancing_scheme set to INTERNAL_MANAGED. - A global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED. If sessionAffinity is not NONE, and this field is not set to MAGLEV or RING_HASH, session affinity settings will not take effect. Only ROUND_ROBIN and RING_HASH are supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true.", "enum": [ @@ -42065,6 +42072,65 @@ }, "type": "object" }, + "BackendServiceLocalityLoadBalancingPolicyConfig": { + "description": "Container for either a built-in LB policy supported by gRPC or Envoy or a custom one implemented by the end user.", + "id": "BackendServiceLocalityLoadBalancingPolicyConfig", + "properties": { + "customPolicy": { + "$ref": "BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy" + }, + "policy": { + "$ref": "BackendServiceLocalityLoadBalancingPolicyConfigPolicy" + } + }, + "type": "object" + }, + "BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy": { + "description": "The configuration for a custom policy implemented by the user and deployed with the client.", + "id": "BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy", + "properties": { + "data": { + "description": "An optional, arbitrary JSON object with configuration data, understood by a locally installed custom policy implementation.", + "type": "string" + }, + "name": { + "description": "Identifies the custom policy. The value should match the type the custom implementation is registered with on the gRPC clients. It should follow protocol buffer message naming conventions and include the full path (e.g. myorg.CustomLbPolicy). The maximum length is 256 characters. Note that specifying the same custom policy more than once for a backend is not a valid configuration and will be rejected.", + "type": "string" + } + }, + "type": "object" + }, + "BackendServiceLocalityLoadBalancingPolicyConfigPolicy": { + "description": "The configuration for a built-in load balancing policy.", + "id": "BackendServiceLocalityLoadBalancingPolicyConfigPolicy", + "properties": { + "name": { + "description": "The name of a locality load balancer policy to be used. The value should be one of the predefined ones as supported by localityLbPolicy, although at the moment only ROUND_ROBIN is supported. This field should only be populated when the customPolicy field is not used. Note that specifying the same policy more than once for a backend is not a valid configuration and will be rejected.", + "enum": [ + "INVALID_LB_POLICY", + "LEAST_REQUEST", + "MAGLEV", + "ORIGINAL_DESTINATION", + "RANDOM", + "RING_HASH", + "ROUND_ROBIN", + "WEIGHTED_MAGLEV" + ], + "enumDescriptions": [ + "", + "An O(1) algorithm which selects two random healthy hosts and picks the host which has fewer active requests.", + "This algorithm implements consistent hashing to backends. Maglev can be used as a drop in replacement for the ring hash load balancer. Maglev is not as stable as ring hash but has faster table lookup build times and host selection times. For more information about Maglev, see https://ai.google/research/pubs/pub44824", + "Backend host is selected based on the client connection metadata, i.e., connections are opened to the same address as the destination address of the incoming connection before the connection was redirected to the load balancer.", + "The load balancer selects a random healthy host.", + "The ring/modulo hash load balancer implements consistent hashing to backends. The algorithm has the property that the addition/removal of a host from a set of N hosts only affects 1/N of the requests.", + "This is a simple policy in which each healthy backend is selected in round robin order. This is the default.", + "Per-instance weighted Load Balancing via health check reported weights. If set, the Backend Service must configure a non legacy HTTP-based Health Check, and health check replies are expected to contain non-standard HTTP response header field X-Load-Balancing-Endpoint-Weight to specify the per-instance weights. If set, Load Balancing is weighted based on the per-instance weights reported in the last processed health check replies, as long as every instance either reported a valid weight or had UNAVAILABLE_WEIGHT. Otherwise, Load Balancing remains equal-weight. This option is only supported in Network Load Balancing." + ], + "type": "string" + } + }, + "type": "object" + }, "BackendServiceLogConfig": { "description": "The available logging options for the load balancer traffic served by this backend service.", "id": "BackendServiceLogConfig", @@ -49764,7 +49830,7 @@ "description": "Encrypts or decrypts data for an instance with a customer-supplied encryption key. If you are creating a new instance, this field encrypts the local SSD and in-memory contents of the instance using a key that you provide. If you are restarting an instance protected with a customer-supplied encryption key, you must provide the correct key in order to successfully restart the instance. If you do not provide an encryption key when creating the instance, then the local SSD and in-memory contents will be encrypted using an automatically generated key and you do not need to provide a key to start the instance later. Instance templates do not store customer-supplied encryption keys, so you cannot use your own keys to encrypt local SSDs and in-memory content in a managed instance group." }, "keyRevocationActionType": { - "description": "KeyRevocationActionType of the instance.", + "description": "KeyRevocationActionType of the instance. Supported options are \"STOP\" and \"NONE\". The default value is \"NONE\" if it is not specified.", "enum": [ "KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", "NONE", @@ -52417,7 +52483,7 @@ "type": "array" }, "keyRevocationActionType": { - "description": "KeyRevocationActionType of the instance.", + "description": "KeyRevocationActionType of the instance. Supported options are \"STOP\" and \"NONE\". The default value is \"NONE\" if it is not specified.", "enum": [ "KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", "NONE", @@ -68961,6 +69027,7 @@ "enum": [ "CLOUD_ARMOR", "CLOUD_ARMOR_EDGE", + "CLOUD_ARMOR_INTERNAL_SERVICE", "CLOUD_ARMOR_NETWORK", "FIREWALL" ], @@ -68968,6 +69035,7 @@ "", "", "", + "", "" ], "type": "string" @@ -70788,7 +70856,7 @@ "type": "array" }, "keyRevocationActionType": { - "description": "KeyRevocationActionType of the instance.", + "description": "KeyRevocationActionType of the instance. Supported options are \"STOP\" and \"NONE\". The default value is \"NONE\" if it is not specified.", "enum": [ "KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", "NONE", @@ -72019,7 +72087,7 @@ "type": "boolean" }, "externalIpv6Prefix": { - "description": "[Output Only] The range of external IPv6 addresses that are owned by this subnetwork.", + "description": "[Output Only] The external IPv6 address range that is assigned to this subnetwork.", "type": "string" }, "fingerprint": { @@ -72042,7 +72110,7 @@ "type": "string" }, "internalIpv6Prefix": { - "description": "[Output Only] The range of internal IPv6 addresses that are owned by this subnetwork. Note this is for general VM to VM communication, not to be confused with the ipv6_cidr_range field.", + "description": "[Output Only] The internal IPv6 address range that is assigned to this subnetwork.", "type": "string" }, "ipCidrRange": { @@ -72050,19 +72118,19 @@ "type": "string" }, "ipv6AccessType": { - "description": "The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack. If the ipv6_type is EXTERNAL then this subnet cannot enable direct path.", + "description": "The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack.", "enum": [ "EXTERNAL", "INTERNAL" ], "enumDescriptions": [ - "VMs on this subnet will be assigned IPv6 addresses that are accesible via the Internet, as well as the VPC network.", + "VMs on this subnet will be assigned IPv6 addresses that are accessible via the Internet, as well as the VPC network.", "VMs on this subnet will be assigned IPv6 addresses that are only accessible over the VPC network." ], "type": "string" }, "ipv6CidrRange": { - "description": "[Output Only] The range of internal IPv6 addresses that are owned by this subnetwork. Note this will be for private google access only eventually.", + "description": "[Output Only] This field is for internal use.", "type": "string" }, "kind": { @@ -72100,7 +72168,7 @@ "type": "boolean" }, "privateIpv6GoogleAccess": { - "description": "The private IPv6 google access type for the VMs in this subnet. This is an expanded field of enablePrivateV6Access. If both fields are set, privateIpv6GoogleAccess will take priority. This field can be both set at resource creation time and updated using patch.", + "description": "This field is for internal use. This field can be both set at resource creation time and updated using patch.", "enum": [ "DISABLE_GOOGLE_ACCESS", "ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE", diff --git a/compute/v0.alpha/compute-gen.go b/compute/v0.alpha/compute-gen.go index 7a167d994b2..8532e6493c3 100644 --- a/compute/v0.alpha/compute-gen.go +++ b/compute/v0.alpha/compute-gen.go @@ -5662,6 +5662,14 @@ type BackendService struct { // "INVALID_LOAD_BALANCING_SCHEME" LoadBalancingScheme string `json:"loadBalancingScheme,omitempty"` + // LocalityLbPolicies: A list of locality load balancing policies to be + // used in order of preference. Either the policy or the customPolicy + // field should be set. Overrides any value set in the localityLbPolicy + // field. localityLbPolicies is only supported when the BackendService + // is referenced by a URL Map that is referenced by a target gRPC proxy + // that has the validateForProxyless field set to true. + LocalityLbPolicies []*BackendServiceLocalityLoadBalancingPolicyConfig `json:"localityLbPolicies,omitempty"` + // LocalityLbPolicy: The load balancing algorithm used within the scope // of the locality. The possible values are: - ROUND_ROBIN: This is a // simple policy in which each healthy backend is selected in round @@ -6803,6 +6811,142 @@ func (s *BackendServiceListWarningData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// BackendServiceLocalityLoadBalancingPolicyConfig: Container for either +// a built-in LB policy supported by gRPC or Envoy or a custom one +// implemented by the end user. +type BackendServiceLocalityLoadBalancingPolicyConfig struct { + CustomPolicy *BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy `json:"customPolicy,omitempty"` + + Policy *BackendServiceLocalityLoadBalancingPolicyConfigPolicy `json:"policy,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CustomPolicy") 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. "CustomPolicy") 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 *BackendServiceLocalityLoadBalancingPolicyConfig) MarshalJSON() ([]byte, error) { + type NoMethod BackendServiceLocalityLoadBalancingPolicyConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy: The +// configuration for a custom policy implemented by the user and +// deployed with the client. +type BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy struct { + // Data: An optional, arbitrary JSON object with configuration data, + // understood by a locally installed custom policy implementation. + Data string `json:"data,omitempty"` + + // Name: Identifies the custom policy. The value should match the type + // the custom implementation is registered with on the gRPC clients. It + // should follow protocol buffer message naming conventions and include + // the full path (e.g. myorg.CustomLbPolicy). The maximum length is 256 + // characters. Note that specifying the same custom policy more than + // once for a backend is not a valid configuration and will be rejected. + Name string `json:"name,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Data") 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. "Data") 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 *BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy) MarshalJSON() ([]byte, error) { + type NoMethod BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BackendServiceLocalityLoadBalancingPolicyConfigPolicy: The +// configuration for a built-in load balancing policy. +type BackendServiceLocalityLoadBalancingPolicyConfigPolicy struct { + // Name: The name of a locality load balancer policy to be used. The + // value should be one of the predefined ones as supported by + // localityLbPolicy, although at the moment only ROUND_ROBIN is + // supported. This field should only be populated when the customPolicy + // field is not used. Note that specifying the same policy more than + // once for a backend is not a valid configuration and will be rejected. + // + // Possible values: + // "INVALID_LB_POLICY" + // "LEAST_REQUEST" - An O(1) algorithm which selects two random + // healthy hosts and picks the host which has fewer active requests. + // "MAGLEV" - This algorithm implements consistent hashing to + // backends. Maglev can be used as a drop in replacement for the ring + // hash load balancer. Maglev is not as stable as ring hash but has + // faster table lookup build times and host selection times. For more + // information about Maglev, see + // https://ai.google/research/pubs/pub44824 + // "ORIGINAL_DESTINATION" - Backend host is selected based on the + // client connection metadata, i.e., connections are opened to the same + // address as the destination address of the incoming connection before + // the connection was redirected to the load balancer. + // "RANDOM" - The load balancer selects a random healthy host. + // "RING_HASH" - The ring/modulo hash load balancer implements + // consistent hashing to backends. The algorithm has the property that + // the addition/removal of a host from a set of N hosts only affects 1/N + // of the requests. + // "ROUND_ROBIN" - This is a simple policy in which each healthy + // backend is selected in round robin order. This is the default. + // "WEIGHTED_MAGLEV" - Per-instance weighted Load Balancing via health + // check reported weights. If set, the Backend Service must configure a + // non legacy HTTP-based Health Check, and health check replies are + // expected to contain non-standard HTTP response header field + // X-Load-Balancing-Endpoint-Weight to specify the per-instance weights. + // If set, Load Balancing is weighted based on the per-instance weights + // reported in the last processed health check replies, as long as every + // instance either reported a valid weight or had UNAVAILABLE_WEIGHT. + // Otherwise, Load Balancing remains equal-weight. This option is only + // supported in Network Load Balancing. + Name string `json:"name,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Name") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. 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. "Name") 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 *BackendServiceLocalityLoadBalancingPolicyConfigPolicy) MarshalJSON() ([]byte, error) { + type NoMethod BackendServiceLocalityLoadBalancingPolicyConfigPolicy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // BackendServiceLogConfig: The available logging options for the load // balancer traffic served by this backend service. type BackendServiceLogConfig struct { @@ -18927,6 +19071,8 @@ type Instance struct { InstanceEncryptionKey *CustomerEncryptionKey `json:"instanceEncryptionKey,omitempty"` // KeyRevocationActionType: KeyRevocationActionType of the instance. + // Supported options are "STOP" and "NONE". The default value is "NONE" + // if it is not specified. // // Possible values: // "KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED" - Default value. This @@ -23267,6 +23413,8 @@ type InstanceProperties struct { GuestAccelerators []*AcceleratorConfig `json:"guestAccelerators,omitempty"` // KeyRevocationActionType: KeyRevocationActionType of the instance. + // Supported options are "STOP" and "NONE". The default value is "NONE" + // if it is not specified. // // Possible values: // "KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED" - Default value. This @@ -48619,6 +48767,7 @@ type SecurityPolicy struct { // Possible values: // "CLOUD_ARMOR" // "CLOUD_ARMOR_EDGE" + // "CLOUD_ARMOR_INTERNAL_SERVICE" // "CLOUD_ARMOR_NETWORK" // "FIREWALL" Type string `json:"type,omitempty"` @@ -51539,6 +51688,8 @@ type SourceInstanceProperties struct { GuestAccelerators []*AcceleratorConfig `json:"guestAccelerators,omitempty"` // KeyRevocationActionType: KeyRevocationActionType of the instance. + // Supported options are "STOP" and "NONE". The default value is "NONE" + // if it is not specified. // // Possible values: // "KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED" - Default value. This @@ -53412,8 +53563,8 @@ type Subnetwork struct { // both set at resource creation time and updated using patch. EnablePrivateV6Access bool `json:"enablePrivateV6Access,omitempty"` - // ExternalIpv6Prefix: [Output Only] The range of external IPv6 - // addresses that are owned by this subnetwork. + // ExternalIpv6Prefix: [Output Only] The external IPv6 address range + // that is assigned to this subnetwork. ExternalIpv6Prefix string `json:"externalIpv6Prefix,omitempty"` // Fingerprint: Fingerprint of this resource. A hash of the contents @@ -53441,10 +53592,8 @@ type Subnetwork struct { // identifier is defined by the server. Id uint64 `json:"id,omitempty,string"` - // InternalIpv6Prefix: [Output Only] The range of internal IPv6 - // addresses that are owned by this subnetwork. Note this is for general - // VM to VM communication, not to be confused with the ipv6_cidr_range - // field. + // InternalIpv6Prefix: [Output Only] The internal IPv6 address range + // that is assigned to this subnetwork. InternalIpv6Prefix string `json:"internalIpv6Prefix,omitempty"` // IpCidrRange: The range of internal addresses that are owned by this @@ -53458,19 +53607,16 @@ type Subnetwork struct { // Ipv6AccessType: The access type of IPv6 address this subnet holds. // It's immutable and can only be specified during creation or the first - // time the subnet is updated into IPV4_IPV6 dual stack. If the - // ipv6_type is EXTERNAL then this subnet cannot enable direct path. + // time the subnet is updated into IPV4_IPV6 dual stack. // // Possible values: // "EXTERNAL" - VMs on this subnet will be assigned IPv6 addresses - // that are accesible via the Internet, as well as the VPC network. + // that are accessible via the Internet, as well as the VPC network. // "INTERNAL" - VMs on this subnet will be assigned IPv6 addresses // that are only accessible over the VPC network. Ipv6AccessType string `json:"ipv6AccessType,omitempty"` - // Ipv6CidrRange: [Output Only] The range of internal IPv6 addresses - // that are owned by this subnetwork. Note this will be for private - // google access only eventually. + // Ipv6CidrRange: [Output Only] This field is for internal use. Ipv6CidrRange string `json:"ipv6CidrRange,omitempty"` // Kind: [Output Only] Type of the resource. Always compute#subnetwork @@ -53513,11 +53659,8 @@ type Subnetwork struct { // setPrivateIpGoogleAccess. PrivateIpGoogleAccess bool `json:"privateIpGoogleAccess,omitempty"` - // PrivateIpv6GoogleAccess: The private IPv6 google access type for the - // VMs in this subnet. This is an expanded field of - // enablePrivateV6Access. If both fields are set, - // privateIpv6GoogleAccess will take priority. This field can be both - // set at resource creation time and updated using patch. + // PrivateIpv6GoogleAccess: This field is for internal use. This field + // can be both set at resource creation time and updated using patch. // // Possible values: // "DISABLE_GOOGLE_ACCESS" - Disable private IPv6 access to/from diff --git a/dialogflow/v2/dialogflow-api.json b/dialogflow/v2/dialogflow-api.json index 06b4bddfdad..1f22844bc0c 100644 --- a/dialogflow/v2/dialogflow-api.json +++ b/dialogflow/v2/dialogflow-api.json @@ -8077,7 +8077,7 @@ } } }, - "revision": "20220314", + "revision": "20220330", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AudioInput": { @@ -17846,7 +17846,7 @@ "enumDescriptions": [ "Not specified. This value should never be used.", "Examples do not contain @-prefixed entity type names, but example parts can be annotated with entity types.", - "Templates are not annotated with entity types, but they can contain @-prefixed entity type names as substrings. Template mode has been deprecated. Example mode is the only supported way to create new training phrases. If you have existing training phrases that you've created in template mode, those will continue to work." + "Templates are not annotated with entity types, but they can contain @-prefixed entity type names as substrings. Note: Template mode has been deprecated. Example mode is the only supported way to create new training phrases. If you have existing training phrases in template mode, they will be removed during training and it can cause a drop in agent performance." ], "type": "string" } @@ -18665,7 +18665,7 @@ "type": "object" }, "GoogleProtobufEmpty": { - "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": "GoogleProtobufEmpty", "properties": {}, "type": "object" diff --git a/dialogflow/v2/dialogflow-gen.go b/dialogflow/v2/dialogflow-gen.go index 26c7fde26ba..bd59f3e2745 100644 --- a/dialogflow/v2/dialogflow-gen.go +++ b/dialogflow/v2/dialogflow-gen.go @@ -18576,10 +18576,11 @@ type GoogleCloudDialogflowV2beta1IntentTrainingPhrase struct { // "EXAMPLE" - Examples do not contain @-prefixed entity type names, // but example parts can be annotated with entity types. // "TEMPLATE" - Templates are not annotated with entity types, but - // they can contain @-prefixed entity type names as substrings. Template - // mode has been deprecated. Example mode is the only supported way to - // create new training phrases. If you have existing training phrases - // that you've created in template mode, those will continue to work. + // they can contain @-prefixed entity type names as substrings. Note: + // Template mode has been deprecated. Example mode is the only supported + // way to create new training phrases. If you have existing training + // phrases in template mode, they will be removed during training and it + // can cause a drop in agent performance. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to @@ -20083,8 +20084,7 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { // 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 `{}`. +// returns (google.protobuf.Empty); } type GoogleProtobufEmpty struct { // ServerResponse contains the HTTP response code and headers from the // server. diff --git a/dialogflow/v2beta1/dialogflow-api.json b/dialogflow/v2beta1/dialogflow-api.json index 65f8d3d47b7..8219681c70f 100644 --- a/dialogflow/v2beta1/dialogflow-api.json +++ b/dialogflow/v2beta1/dialogflow-api.json @@ -7431,7 +7431,7 @@ } } }, - "revision": "20220314", + "revision": "20220330", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AudioInput": { @@ -16190,7 +16190,7 @@ "enumDescriptions": [ "Not specified. This value should never be used.", "Examples do not contain @-prefixed entity type names, but example parts can be annotated with entity types.", - "Templates are not annotated with entity types, but they can contain @-prefixed entity type names as substrings. Template mode has been deprecated. Example mode is the only supported way to create new training phrases. If you have existing training phrases that you've created in template mode, those will continue to work." + "Templates are not annotated with entity types, but they can contain @-prefixed entity type names as substrings. Note: Template mode has been deprecated. Example mode is the only supported way to create new training phrases. If you have existing training phrases in template mode, they will be removed during training and it can cause a drop in agent performance." ], "type": "string" } @@ -18176,7 +18176,7 @@ "type": "object" }, "GoogleProtobufEmpty": { - "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": "GoogleProtobufEmpty", "properties": {}, "type": "object" diff --git a/dialogflow/v2beta1/dialogflow-gen.go b/dialogflow/v2beta1/dialogflow-gen.go index 7df52a2eae4..75b1575c0c1 100644 --- a/dialogflow/v2beta1/dialogflow-gen.go +++ b/dialogflow/v2beta1/dialogflow-gen.go @@ -16449,10 +16449,11 @@ type GoogleCloudDialogflowV2beta1IntentTrainingPhrase struct { // "EXAMPLE" - Examples do not contain @-prefixed entity type names, // but example parts can be annotated with entity types. // "TEMPLATE" - Templates are not annotated with entity types, but - // they can contain @-prefixed entity type names as substrings. Template - // mode has been deprecated. Example mode is the only supported way to - // create new training phrases. If you have existing training phrases - // that you've created in template mode, those will continue to work. + // they can contain @-prefixed entity type names as substrings. Note: + // Template mode has been deprecated. Example mode is the only supported + // way to create new training phrases. If you have existing training + // phrases in template mode, they will be removed during training and it + // can cause a drop in agent performance. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to @@ -20178,8 +20179,7 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { // 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 `{}`. +// returns (google.protobuf.Empty); } type GoogleProtobufEmpty struct { // ServerResponse contains the HTTP response code and headers from the // server. diff --git a/dialogflow/v3/dialogflow-api.json b/dialogflow/v3/dialogflow-api.json index aa25e9e80e5..fd51adb098e 100644 --- a/dialogflow/v3/dialogflow-api.json +++ b/dialogflow/v3/dialogflow-api.json @@ -3820,7 +3820,7 @@ } } }, - "revision": "20220314", + "revision": "20220330", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -3881,6 +3881,10 @@ "description": "Indicates if stackdriver logging is enabled for the agent. Please use agent.advanced_settings instead.", "type": "boolean" }, + "locked": { + "description": "Indiciates whether the agent is locked for changes. If the agent is locked, modifications to the agent will be rejected except for RestoreAgent.", + "type": "boolean" + }, "name": { "description": "The unique identifier of the agent. Required for the Agents.UpdateAgent method. Agents.CreateAgent populates the name automatically. Format: `projects//locations//agents/`.", "type": "string" @@ -4880,6 +4884,18 @@ "description": "Optional. The [Google Cloud Storage](https://cloud.google.com/storage/docs/) URI to export the agent to. The format of this URI must be `gs:///`. If left unspecified, the serialized agent is returned inline. Dialogflow performs a write operation for the Cloud Storage object on the caller's behalf, so your request authentication must have write permissions for the object. For more information, see [Dialogflow access control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).", "type": "string" }, + "dataFormat": { + "description": "Optional. The data format of the exported agent. If not specified, `BLOB` is assumed.", + "enum": [ + "DATA_FORMAT_UNSPECIFIED", + "BLOB" + ], + "enumDescriptions": [ + "Unspecified format.", + "Agent content will be exported as raw bytes." + ], + "type": "string" + }, "environment": { "description": "Optional. Environment name. If not set, draft environment is assumed. Format: `projects//locations//agents//environments/`.", "type": "string" @@ -13282,7 +13298,7 @@ "enumDescriptions": [ "Not specified. This value should never be used.", "Examples do not contain @-prefixed entity type names, but example parts can be annotated with entity types.", - "Templates are not annotated with entity types, but they can contain @-prefixed entity type names as substrings. Template mode has been deprecated. Example mode is the only supported way to create new training phrases. If you have existing training phrases that you've created in template mode, those will continue to work." + "Templates are not annotated with entity types, but they can contain @-prefixed entity type names as substrings. Note: Template mode has been deprecated. Example mode is the only supported way to create new training phrases. If you have existing training phrases in template mode, they will be removed during training and it can cause a drop in agent performance." ], "type": "string" } @@ -14101,7 +14117,7 @@ "type": "object" }, "GoogleProtobufEmpty": { - "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": "GoogleProtobufEmpty", "properties": {}, "type": "object" diff --git a/dialogflow/v3/dialogflow-gen.go b/dialogflow/v3/dialogflow-gen.go index 5cfdaf734f3..49fd46e61e6 100644 --- a/dialogflow/v3/dialogflow-gen.go +++ b/dialogflow/v3/dialogflow-gen.go @@ -544,6 +544,11 @@ type GoogleCloudDialogflowCxV3Agent struct { // for the agent. Please use agent.advanced_settings instead. EnableStackdriverLogging bool `json:"enableStackdriverLogging,omitempty"` + // Locked: Indiciates whether the agent is locked for changes. If the + // agent is locked, modifications to the agent will be rejected except + // for RestoreAgent. + Locked bool `json:"locked,omitempty"` + // Name: The unique identifier of the agent. Required for the // Agents.UpdateAgent method. Agents.CreateAgent populates the name // automatically. Format: `projects//locations//agents/`. @@ -2322,6 +2327,14 @@ type GoogleCloudDialogflowCxV3ExportAgentRequest struct { // (https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage). AgentUri string `json:"agentUri,omitempty"` + // DataFormat: Optional. The data format of the exported agent. If not + // specified, `BLOB` is assumed. + // + // Possible values: + // "DATA_FORMAT_UNSPECIFIED" - Unspecified format. + // "BLOB" - Agent content will be exported as raw bytes. + DataFormat string `json:"dataFormat,omitempty"` + // Environment: Optional. Environment name. If not set, draft // environment is assumed. Format: // `projects//locations//agents//environments/`. @@ -17478,10 +17491,11 @@ type GoogleCloudDialogflowV2beta1IntentTrainingPhrase struct { // "EXAMPLE" - Examples do not contain @-prefixed entity type names, // but example parts can be annotated with entity types. // "TEMPLATE" - Templates are not annotated with entity types, but - // they can contain @-prefixed entity type names as substrings. Template - // mode has been deprecated. Example mode is the only supported way to - // create new training phrases. If you have existing training phrases - // that you've created in template mode, those will continue to work. + // they can contain @-prefixed entity type names as substrings. Note: + // Template mode has been deprecated. Example mode is the only supported + // way to create new training phrases. If you have existing training + // phrases in template mode, they will be removed during training and it + // can cause a drop in agent performance. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to @@ -18985,8 +18999,7 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { // 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 `{}`. +// returns (google.protobuf.Empty); } type GoogleProtobufEmpty struct { // ServerResponse contains the HTTP response code and headers from the // server. diff --git a/dialogflow/v3beta1/dialogflow-api.json b/dialogflow/v3beta1/dialogflow-api.json index c1b182c4d94..4df2247dce0 100644 --- a/dialogflow/v3beta1/dialogflow-api.json +++ b/dialogflow/v3beta1/dialogflow-api.json @@ -3820,7 +3820,7 @@ } } }, - "revision": "20220314", + "revision": "20220330", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AudioInput": { @@ -5573,6 +5573,10 @@ "description": "Indicates if stackdriver logging is enabled for the agent. Please use agent.advanced_settings instead.", "type": "boolean" }, + "locked": { + "description": "Indiciates whether the agent is locked for changes. If the agent is locked, modifications to the agent will be rejected except for RestoreAgent.", + "type": "boolean" + }, "name": { "description": "The unique identifier of the agent. Required for the Agents.UpdateAgent method. Agents.CreateAgent populates the name automatically. Format: `projects//locations//agents/`.", "type": "string" @@ -6572,6 +6576,18 @@ "description": "Optional. The [Google Cloud Storage](https://cloud.google.com/storage/docs/) URI to export the agent to. The format of this URI must be `gs:///`. If left unspecified, the serialized agent is returned inline. Dialogflow performs a write operation for the Cloud Storage object on the caller's behalf, so your request authentication must have write permissions for the object. For more information, see [Dialogflow access control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).", "type": "string" }, + "dataFormat": { + "description": "Optional. The data format of the exported agent. If not specified, `BLOB` is assumed.", + "enum": [ + "DATA_FORMAT_UNSPECIFIED", + "BLOB" + ], + "enumDescriptions": [ + "Unspecified format.", + "Agent content will be exported as raw bytes." + ], + "type": "string" + }, "environment": { "description": "Optional. Environment name. If not set, draft environment is assumed. Format: `projects//locations//agents//environments/`.", "type": "string" @@ -13282,7 +13298,7 @@ "enumDescriptions": [ "Not specified. This value should never be used.", "Examples do not contain @-prefixed entity type names, but example parts can be annotated with entity types.", - "Templates are not annotated with entity types, but they can contain @-prefixed entity type names as substrings. Template mode has been deprecated. Example mode is the only supported way to create new training phrases. If you have existing training phrases that you've created in template mode, those will continue to work." + "Templates are not annotated with entity types, but they can contain @-prefixed entity type names as substrings. Note: Template mode has been deprecated. Example mode is the only supported way to create new training phrases. If you have existing training phrases in template mode, they will be removed during training and it can cause a drop in agent performance." ], "type": "string" } @@ -14101,7 +14117,7 @@ "type": "object" }, "GoogleProtobufEmpty": { - "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": "GoogleProtobufEmpty", "properties": {}, "type": "object" diff --git a/dialogflow/v3beta1/dialogflow-gen.go b/dialogflow/v3beta1/dialogflow-gen.go index d8edb107eb5..44f1045e46e 100644 --- a/dialogflow/v3beta1/dialogflow-gen.go +++ b/dialogflow/v3beta1/dialogflow-gen.go @@ -3765,6 +3765,11 @@ type GoogleCloudDialogflowCxV3beta1Agent struct { // for the agent. Please use agent.advanced_settings instead. EnableStackdriverLogging bool `json:"enableStackdriverLogging,omitempty"` + // Locked: Indiciates whether the agent is locked for changes. If the + // agent is locked, modifications to the agent will be rejected except + // for RestoreAgent. + Locked bool `json:"locked,omitempty"` + // Name: The unique identifier of the agent. Required for the // Agents.UpdateAgent method. Agents.CreateAgent populates the name // automatically. Format: `projects//locations//agents/`. @@ -5546,6 +5551,14 @@ type GoogleCloudDialogflowCxV3beta1ExportAgentRequest struct { // (https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage). AgentUri string `json:"agentUri,omitempty"` + // DataFormat: Optional. The data format of the exported agent. If not + // specified, `BLOB` is assumed. + // + // Possible values: + // "DATA_FORMAT_UNSPECIFIED" - Unspecified format. + // "BLOB" - Agent content will be exported as raw bytes. + DataFormat string `json:"dataFormat,omitempty"` + // Environment: Optional. Environment name. If not set, draft // environment is assumed. Format: // `projects//locations//agents//environments/`. @@ -17483,10 +17496,11 @@ type GoogleCloudDialogflowV2beta1IntentTrainingPhrase struct { // "EXAMPLE" - Examples do not contain @-prefixed entity type names, // but example parts can be annotated with entity types. // "TEMPLATE" - Templates are not annotated with entity types, but - // they can contain @-prefixed entity type names as substrings. Template - // mode has been deprecated. Example mode is the only supported way to - // create new training phrases. If you have existing training phrases - // that you've created in template mode, those will continue to work. + // they can contain @-prefixed entity type names as substrings. Note: + // Template mode has been deprecated. Example mode is the only supported + // way to create new training phrases. If you have existing training + // phrases in template mode, they will be removed during training and it + // can cause a drop in agent performance. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Name") to @@ -18990,8 +19004,7 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { // 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 `{}`. +// returns (google.protobuf.Empty); } type GoogleProtobufEmpty struct { // ServerResponse contains the HTTP response code and headers from the // server. diff --git a/firebasedatabase/v1beta/firebasedatabase-api.json b/firebasedatabase/v1beta/firebasedatabase-api.json index 9a8f1597b10..df33a09b34b 100644 --- a/firebasedatabase/v1beta/firebasedatabase-api.json +++ b/firebasedatabase/v1beta/firebasedatabase-api.json @@ -268,6 +268,11 @@ "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string" + }, + "showDeleted": { + "description": "Indicate that DatabaseInstances in the `DELETED` state should also be returned.", + "location": "query", + "type": "boolean" } }, "path": "v1beta/{+parent}/instances", @@ -317,7 +322,7 @@ } } }, - "revision": "20210809", + "revision": "20220328", "rootUrl": "https://firebasedatabase.googleapis.com/", "schemas": { "DatabaseInstance": { diff --git a/firebasedatabase/v1beta/firebasedatabase-gen.go b/firebasedatabase/v1beta/firebasedatabase-gen.go index a4e320b28b2..35f7ee2a51c 100644 --- a/firebasedatabase/v1beta/firebasedatabase-gen.go +++ b/firebasedatabase/v1beta/firebasedatabase-gen.go @@ -973,6 +973,13 @@ func (c *ProjectsLocationsInstancesListCall) PageToken(pageToken string) *Projec return c } +// ShowDeleted sets the optional parameter "showDeleted": Indicate that +// DatabaseInstances in the `DELETED` state should also be returned. +func (c *ProjectsLocationsInstancesListCall) ShowDeleted(showDeleted bool) *ProjectsLocationsInstancesListCall { + c.urlParams_.Set("showDeleted", fmt.Sprint(showDeleted)) + return c +} + // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. @@ -1097,6 +1104,11 @@ func (c *ProjectsLocationsInstancesListCall) Do(opts ...googleapi.CallOption) (* // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, // "type": "string" + // }, + // "showDeleted": { + // "description": "Indicate that DatabaseInstances in the `DELETED` state should also be returned.", + // "location": "query", + // "type": "boolean" // } // }, // "path": "v1beta/{+parent}/instances", diff --git a/homegraph/v1/homegraph-api.json b/homegraph/v1/homegraph-api.json index 2a681caf240..37708310eee 100644 --- a/homegraph/v1/homegraph-api.json +++ b/homegraph/v1/homegraph-api.json @@ -216,7 +216,7 @@ } } }, - "revision": "20210402", + "revision": "20220325", "rootUrl": "https://homegraph.googleapis.com/", "schemas": { "AgentDeviceId": { @@ -363,7 +363,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/homegraph/v1/homegraph-gen.go b/homegraph/v1/homegraph-gen.go index 0de1d54edff..e81926b9daf 100644 --- a/homegraph/v1/homegraph-gen.go +++ b/homegraph/v1/homegraph-gen.go @@ -372,8 +372,7 @@ func (s *DeviceNames) 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. diff --git a/ondemandscanning/v1/ondemandscanning-api.json b/ondemandscanning/v1/ondemandscanning-api.json index 2d599c629ba..59dc8ac9d28 100644 --- a/ondemandscanning/v1/ondemandscanning-api.json +++ b/ondemandscanning/v1/ondemandscanning-api.json @@ -339,7 +339,7 @@ } } }, - "revision": "20220107", + "revision": "20220326", "rootUrl": "https://ondemandscanning.googleapis.com/", "schemas": { "AliasContext": { @@ -984,7 +984,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/ondemandscanning/v1/ondemandscanning-gen.go b/ondemandscanning/v1/ondemandscanning-gen.go index 73a4d379094..fc48d86a5d8 100644 --- a/ondemandscanning/v1/ondemandscanning-gen.go +++ b/ondemandscanning/v1/ondemandscanning-gen.go @@ -1098,8 +1098,7 @@ func (s *DiscoveryOccurrence) 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. diff --git a/ondemandscanning/v1beta1/ondemandscanning-api.json b/ondemandscanning/v1beta1/ondemandscanning-api.json index d53166671d1..3a6511db4e1 100644 --- a/ondemandscanning/v1beta1/ondemandscanning-api.json +++ b/ondemandscanning/v1beta1/ondemandscanning-api.json @@ -339,7 +339,7 @@ } } }, - "revision": "20220107", + "revision": "20220326", "rootUrl": "https://ondemandscanning.googleapis.com/", "schemas": { "AliasContext": { @@ -980,7 +980,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/ondemandscanning/v1beta1/ondemandscanning-gen.go b/ondemandscanning/v1beta1/ondemandscanning-gen.go index 0d558552ad8..e50031f16e9 100644 --- a/ondemandscanning/v1beta1/ondemandscanning-gen.go +++ b/ondemandscanning/v1beta1/ondemandscanning-gen.go @@ -1092,8 +1092,7 @@ func (s *DiscoveryOccurrence) 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. diff --git a/osconfig/v1/osconfig-api.json b/osconfig/v1/osconfig-api.json index 91d9a8ee3ad..970b209a049 100644 --- a/osconfig/v1/osconfig-api.json +++ b/osconfig/v1/osconfig-api.json @@ -1000,7 +1000,7 @@ } } }, - "revision": "20220301", + "revision": "20220319", "rootUrl": "https://osconfig.googleapis.com/", "schemas": { "AptSettings": { @@ -1219,7 +1219,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/osconfig/v1/osconfig-gen.go b/osconfig/v1/osconfig-gen.go index 5d7b15c234f..91e8613a3e6 100644 --- a/osconfig/v1/osconfig-gen.go +++ b/osconfig/v1/osconfig-gen.go @@ -555,8 +555,7 @@ func (s *Date) 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. diff --git a/osconfig/v1alpha/osconfig-api.json b/osconfig/v1alpha/osconfig-api.json index 18c04932db7..035c4e6b770 100644 --- a/osconfig/v1alpha/osconfig-api.json +++ b/osconfig/v1alpha/osconfig-api.json @@ -684,7 +684,7 @@ } } }, - "revision": "20220301", + "revision": "20220319", "rootUrl": "https://osconfig.googleapis.com/", "schemas": { "CVSSv3": { @@ -862,7 +862,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/osconfig/v1alpha/osconfig-gen.go b/osconfig/v1alpha/osconfig-gen.go index 7c3487655bf..4f3e928766e 100644 --- a/osconfig/v1alpha/osconfig-gen.go +++ b/osconfig/v1alpha/osconfig-gen.go @@ -481,8 +481,7 @@ func (s *Date) 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. diff --git a/osconfig/v1beta/osconfig-api.json b/osconfig/v1beta/osconfig-api.json index ade9c5ba0d0..eef237c53fd 100644 --- a/osconfig/v1beta/osconfig-api.json +++ b/osconfig/v1beta/osconfig-api.json @@ -689,7 +689,7 @@ } } }, - "revision": "20220301", + "revision": "20220319", "rootUrl": "https://osconfig.googleapis.com/", "schemas": { "AptRepository": { @@ -922,7 +922,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/osconfig/v1beta/osconfig-gen.go b/osconfig/v1beta/osconfig-gen.go index d5128bbce9e..c0baa4b1778 100644 --- a/osconfig/v1beta/osconfig-gen.go +++ b/osconfig/v1beta/osconfig-gen.go @@ -595,8 +595,7 @@ func (s *EffectiveGuestPolicySourcedSoftwareRecipe) 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. diff --git a/retail/v2/retail-api.json b/retail/v2/retail-api.json index 376d59a35ae..a934e4ba79d 100644 --- a/retail/v2/retail-api.json +++ b/retail/v2/retail-api.json @@ -112,7 +112,7 @@ "catalogs": { "methods": { "completeQuery": { - "description": "Completes the specified prefix with keyword suggestions. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + "description": "Completes the specified prefix with keyword suggestions. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}:completeQuery", "httpMethod": "GET", "id": "retail.projects.locations.catalogs.completeQuery", @@ -327,7 +327,7 @@ "products": { "methods": { "addFulfillmentPlaces": { - "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addFulfillmentPlaces", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.addFulfillmentPlaces", @@ -354,6 +354,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "addLocalInventories": { + "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be modified using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addLocalInventories", + "httpMethod": "POST", + "id": "retail.projects.locations.catalogs.branches.products.addLocalInventories", + "parameterOrder": [ + "product" + ], + "parameters": { + "product": { + "description": "Required. Full resource name of Product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/some_product_id`. If the caller does not have permission to access the Product, regardless of whether or not it exists, a PERMISSION_DENIED error is returned.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/branches/[^/]+/products/.*$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+product}:addLocalInventories", + "request": { + "$ref": "GoogleCloudRetailV2AddLocalInventoriesRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "create": { "description": "Creates a Product.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products", @@ -552,7 +580,7 @@ ] }, "removeFulfillmentPlaces": { - "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeFulfillmentPlaces", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.removeFulfillmentPlaces", @@ -579,8 +607,36 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "removeLocalInventories": { + "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be removed using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeLocalInventories", + "httpMethod": "POST", + "id": "retail.projects.locations.catalogs.branches.products.removeLocalInventories", + "parameterOrder": [ + "product" + ], + "parameters": { + "product": { + "description": "Required. Full resource name of Product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/some_product_id`. If the caller does not have permission to access the Product, regardless of whether or not it exists, a PERMISSION_DENIED error is returned.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/branches/[^/]+/products/.*$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+product}:removeLocalInventories", + "request": { + "$ref": "GoogleCloudRetailV2RemoveLocalInventoriesRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "setInventory": { - "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. When inventory is updated with CreateProduct and UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the CreateProduct or UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with SetInventory, AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. When inventory is updated with CreateProduct and UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the CreateProduct or UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with SetInventory, AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:setInventory", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.setInventory", @@ -614,7 +670,7 @@ "completionData": { "methods": { "import": { - "description": "Bulk import of processed completion dataset. Request processing is asynchronous. Partial updating is not supported. The operation is successfully finished only after the imported suggestions are indexed successfully and ready for serving. The process takes hours. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + "description": "Bulk import of processed completion dataset. Request processing is asynchronous. Partial updating is not supported. The operation is successfully finished only after the imported suggestions are indexed successfully and ready for serving. The process takes hours. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/completionData:import", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.completionData.import", @@ -744,7 +800,7 @@ ] }, "search": { - "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/placements/{placementsId}:search", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.placements.search", @@ -804,7 +860,7 @@ ] }, "search": { - "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/servingConfigs/{servingConfigsId}:search", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.servingConfigs.search", @@ -1137,7 +1193,7 @@ } } }, - "revision": "20220319", + "revision": "20220324", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -1329,6 +1385,46 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2AddLocalInventoriesMetadata": { + "description": "Metadata related to the progress of the AddLocalInventories operation. Currently empty because there is no meaningful metadata populated from the AddLocalInventories method.", + "id": "GoogleCloudRetailV2AddLocalInventoriesMetadata", + "properties": {}, + "type": "object" + }, + "GoogleCloudRetailV2AddLocalInventoriesRequest": { + "description": "Request message for AddLocalInventories method.", + "id": "GoogleCloudRetailV2AddLocalInventoriesRequest", + "properties": { + "addMask": { + "description": "Indicates which inventory fields in the provided list of LocalInventory to update. The field is updated to the provided value. If a field is set while the place does not have a previous local inventory, the local inventory at that store is created. If a field is set while the value of that field is not provided, the original field value, if it exists, is deleted. If the mask is not set or set with empty paths, all inventory fields will be updated. If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned and the entire update will be ignored.", + "format": "google-fieldmask", + "type": "string" + }, + "addTime": { + "description": "The time when the inventory updates are issued. Used to prevent out-of-order updates on local inventory fields. If not provided, the internal system time will be used.", + "format": "google-datetime", + "type": "string" + }, + "allowMissing": { + "description": "If set to true, and the Product is not found, the local inventory will still be processed and retained for at most 1 day and processed once the Product is created. If set to false, a NOT_FOUND error is returned if the Product is not found.", + "type": "boolean" + }, + "localInventories": { + "description": "Required. A list of inventory information at difference places. Each place is identified by its place ID. At most 3000 inventories are allowed per request.", + "items": { + "$ref": "GoogleCloudRetailV2LocalInventory" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2AddLocalInventoriesResponse": { + "description": "Response of the AddLocalInventories API. Currently empty because there is no meaningful response populated from the AddLocalInventories method.", + "id": "GoogleCloudRetailV2AddLocalInventoriesResponse", + "properties": {}, + "type": "object" + }, "GoogleCloudRetailV2Audience": { "description": "An intended audience of the Product for whom it's sold.", "id": "GoogleCloudRetailV2Audience", @@ -1714,7 +1810,7 @@ "enumDescriptions": [ "Defaults to INCREMENTAL.", "Inserts new products or updates existing products.", - "Calculates diff and replaces the entire product dataset. Existing products may be deleted if they are not present in the source location. Can only be set while using BigQuerySource. And the BigQuery dataset must be created in the data location \"us (multiple regions in United States)\", otherwise a PERMISSION_DENIED error is thrown. Add the IAM permission \"BigQuery Data Viewer\" for cloud-retail-customer-data-access@system.gserviceaccount.com before using this feature otherwise an error is thrown. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search." + "Calculates diff and replaces the entire product dataset. Existing products may be deleted if they are not present in the source location. Can only be set while using BigQuerySource. And the BigQuery dataset must be created in the data location \"us (multiple regions in United States)\", otherwise a PERMISSION_DENIED error is thrown. Add the IAM permission \"BigQuery Data Viewer\" for cloud-retail-customer-data-access@system.gserviceaccount.com before using this feature otherwise an error is thrown." ], "type": "string" }, @@ -1848,6 +1944,35 @@ }, "type": "object" }, + "GoogleCloudRetailV2LocalInventory": { + "description": "The inventory information at a place (e.g. a store) identified by a place ID.", + "id": "GoogleCloudRetailV2LocalInventory", + "properties": { + "attributes": { + "additionalProperties": { + "$ref": "GoogleCloudRetailV2CustomAttribute" + }, + "description": "Additional local inventory attributes, for example, store name, promotion tags, etc. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * At most 30 attributes are allowed. * The key must be a UTF-8 encoded string with a length limit of 32 characters. * The key must match the pattern: `a-zA-Z0-9*`. For example, key0LikeThis or KEY_1_LIKE_THIS. * The attribute values must be of the same type (text or number). * Only 1 value is allowed for each attribute. * For text values, the length limit is 256 UTF-8 characters. * The attribute does not support search. The `searchable` field should be unset or set to false. * The max summed total bytes of custom attribute keys and values per product is 5MiB.", + "type": "object" + }, + "fulfillmentTypes": { + "description": "Input only. Supported fulfillment types. Valid fulfillment type values include commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * \"pickup-in-store\" * \"ship-to-store\" * \"same-day-delivery\" * \"next-day-delivery\" * \"custom-type-1\" * \"custom-type-2\" * \"custom-type-3\" * \"custom-type-4\" * \"custom-type-5\" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. All the elements must be distinct. Otherwise, an INVALID_ARGUMENT error is returned.", + "items": { + "type": "string" + }, + "type": "array" + }, + "placeId": { + "description": "The place ID for the current set of inventory information.", + "type": "string" + }, + "priceInfo": { + "$ref": "GoogleCloudRetailV2PriceInfo", + "description": "Product price and cost information. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371)." + } + }, + "type": "object" + }, "GoogleCloudRetailV2PredictRequest": { "description": "Request message for Predict method.", "id": "GoogleCloudRetailV2PredictRequest", @@ -2445,6 +2570,41 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2RemoveLocalInventoriesMetadata": { + "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the RemoveLocalInventories method.", + "id": "GoogleCloudRetailV2RemoveLocalInventoriesMetadata", + "properties": {}, + "type": "object" + }, + "GoogleCloudRetailV2RemoveLocalInventoriesRequest": { + "description": "Request message for RemoveLocalInventories method.", + "id": "GoogleCloudRetailV2RemoveLocalInventoriesRequest", + "properties": { + "allowMissing": { + "description": "If set to true, and the Product is not found, the local inventory removal request will still be processed and retained for at most 1 day and processed once the Product is created. If set to false, a NOT_FOUND error is returned if the Product is not found.", + "type": "boolean" + }, + "placeIds": { + "description": "Required. A list of place IDs to have their inventory deleted. At most 3000 place IDs are allowed per request.", + "items": { + "type": "string" + }, + "type": "array" + }, + "removeTime": { + "description": "The time when the inventory deletions are issued. Used to prevent out-of-order updates and deletions on local inventory fields. If not provided, the internal system time will be used.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2RemoveLocalInventoriesResponse": { + "description": "Response of the RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the RemoveLocalInventories method.", + "id": "GoogleCloudRetailV2RemoveLocalInventoriesResponse", + "properties": {}, + "type": "object" + }, "GoogleCloudRetailV2SearchRequest": { "description": "Request message for SearchService.Search method.", "id": "GoogleCloudRetailV2SearchRequest", @@ -2463,7 +2623,7 @@ }, "dynamicFacetSpec": { "$ref": "GoogleCloudRetailV2SearchRequestDynamicFacetSpec", - "description": "The specification for dynamically generated facets. Notice that only textual facets can be dynamically generated. This feature requires additional allowlisting. Contact Retail Search support team if you are interested in using dynamic facet feature." + "description": "Deprecated. Refer to https://cloud.google.com/retail/docs/configs#dynamic to enable dynamic facets. Do not set this field. The specification for dynamically generated facets. Notice that only textual facets can be dynamically generated." }, "facetSpecs": { "description": "Facet specifications for faceted search. If empty, no facets are returned. A maximum of 100 values are allowed. Otherwise, an INVALID_ARGUMENT error is returned.", @@ -3089,7 +3249,7 @@ "type": "boolean" }, "ipAddress": { - "description": "The end user's IP address. Required for getting SearchResponse.sponsored_results. This field is used to extract location information for personalization. This field must be either an IPv4 address (e.g. \"104.133.9.80\") or an IPv6 address (e.g. \"2001:0db8:85a3:0000:0000:8a2e:0370:7334\"). Otherwise, an INVALID_ARGUMENT error is returned. This should not be set when using the JavaScript tag in UserEventService.CollectUserEvent or if direct_user_request is set.", + "description": "The end user's IP address. This field is used to extract location information for personalization. This field must be either an IPv4 address (e.g. \"104.133.9.80\") or an IPv6 address (e.g. \"2001:0db8:85a3:0000:0000:8a2e:0370:7334\"). Otherwise, an INVALID_ARGUMENT error is returned. This should not be set when: * setting SearchRequest.user_info. * using the JavaScript tag in UserEventService.CollectUserEvent or if direct_user_request is set.", "type": "string" }, "userAgent": { @@ -3097,7 +3257,7 @@ "type": "string" }, "userId": { - "description": "Highly recommended for logged-in users. Unique identifier for logged-in user, such as a user name. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", + "description": "Highly recommended for logged-in users. Unique identifier for logged-in user, such as a user name. Always use a hashed value for this ID. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", "type": "string" } }, @@ -3438,6 +3598,18 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2betaAddLocalInventoriesMetadata": { + "description": "Metadata related to the progress of the AddLocalInventories operation. Currently empty because there is no meaningful metadata populated from the AddLocalInventories method.", + "id": "GoogleCloudRetailV2betaAddLocalInventoriesMetadata", + "properties": {}, + "type": "object" + }, + "GoogleCloudRetailV2betaAddLocalInventoriesResponse": { + "description": "Response of the AddLocalInventories API. Currently empty because there is no meaningful response populated from the AddLocalInventories method.", + "id": "GoogleCloudRetailV2betaAddLocalInventoriesResponse", + "properties": {}, + "type": "object" + }, "GoogleCloudRetailV2betaExportErrorsConfig": { "description": "Configuration of destination for Export related errors.", "id": "GoogleCloudRetailV2betaExportErrorsConfig", @@ -3650,6 +3822,18 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata": { + "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the RemoveLocalInventories method.", + "id": "GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata", + "properties": {}, + "type": "object" + }, + "GoogleCloudRetailV2betaRemoveLocalInventoriesResponse": { + "description": "Response of the RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the RemoveLocalInventories method.", + "id": "GoogleCloudRetailV2betaRemoveLocalInventoriesResponse", + "properties": {}, + "type": "object" + }, "GoogleCloudRetailV2betaSetInventoryMetadata": { "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the SetInventory method.", "id": "GoogleCloudRetailV2betaSetInventoryMetadata", diff --git a/retail/v2/retail-gen.go b/retail/v2/retail-gen.go index 9cdb7ad9a7a..b830d8fb4fb 100644 --- a/retail/v2/retail-gen.go +++ b/retail/v2/retail-gen.go @@ -653,6 +653,72 @@ func (s *GoogleCloudRetailV2AddFulfillmentPlacesRequest) MarshalJSON() ([]byte, type GoogleCloudRetailV2AddFulfillmentPlacesResponse struct { } +// GoogleCloudRetailV2AddLocalInventoriesMetadata: Metadata related to +// the progress of the AddLocalInventories operation. Currently empty +// because there is no meaningful metadata populated from the +// AddLocalInventories method. +type GoogleCloudRetailV2AddLocalInventoriesMetadata struct { +} + +// GoogleCloudRetailV2AddLocalInventoriesRequest: Request message for +// AddLocalInventories method. +type GoogleCloudRetailV2AddLocalInventoriesRequest struct { + // AddMask: Indicates which inventory fields in the provided list of + // LocalInventory to update. The field is updated to the provided value. + // If a field is set while the place does not have a previous local + // inventory, the local inventory at that store is created. If a field + // is set while the value of that field is not provided, the original + // field value, if it exists, is deleted. If the mask is not set or set + // with empty paths, all inventory fields will be updated. If an + // unsupported or unknown field is provided, an INVALID_ARGUMENT error + // is returned and the entire update will be ignored. + AddMask string `json:"addMask,omitempty"` + + // AddTime: The time when the inventory updates are issued. Used to + // prevent out-of-order updates on local inventory fields. If not + // provided, the internal system time will be used. + AddTime string `json:"addTime,omitempty"` + + // AllowMissing: If set to true, and the Product is not found, the local + // inventory will still be processed and retained for at most 1 day and + // processed once the Product is created. If set to false, a NOT_FOUND + // error is returned if the Product is not found. + AllowMissing bool `json:"allowMissing,omitempty"` + + // LocalInventories: Required. A list of inventory information at + // difference places. Each place is identified by its place ID. At most + // 3000 inventories are allowed per request. + LocalInventories []*GoogleCloudRetailV2LocalInventory `json:"localInventories,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AddMask") 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. "AddMask") 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 *GoogleCloudRetailV2AddLocalInventoriesRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2AddLocalInventoriesRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2AddLocalInventoriesResponse: Response of the +// AddLocalInventories API. Currently empty because there is no +// meaningful response populated from the AddLocalInventories method. +type GoogleCloudRetailV2AddLocalInventoriesResponse struct { +} + // GoogleCloudRetailV2Audience: An intended audience of the Product for // whom it's sold. type GoogleCloudRetailV2Audience struct { @@ -1471,10 +1537,7 @@ type GoogleCloudRetailV2ImportProductsRequest struct { // regions in United States)", otherwise a PERMISSION_DENIED error is // thrown. Add the IAM permission "BigQuery Data Viewer" for // cloud-retail-customer-data-access@system.gserviceaccount.com before - // using this feature otherwise an error is thrown. This feature is only - // available for users who have Retail Search enabled. Please submit a - // form [here](https://cloud.google.com/contact) to contact cloud sales - // if you are interested in using Retail Search. + // using this feature otherwise an error is thrown. ReconciliationMode string `json:"reconciliationMode,omitempty"` // RequestId: Deprecated. This field has no effect. @@ -1751,6 +1814,65 @@ func (s *GoogleCloudRetailV2ListProductsResponse) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudRetailV2LocalInventory: The inventory information at a +// place (e.g. a store) identified by a place ID. +type GoogleCloudRetailV2LocalInventory struct { + // Attributes: Additional local inventory attributes, for example, store + // name, promotion tags, etc. This field needs to pass all below + // criteria, otherwise an INVALID_ARGUMENT error is returned: * At most + // 30 attributes are allowed. * The key must be a UTF-8 encoded string + // with a length limit of 32 characters. * The key must match the + // pattern: `a-zA-Z0-9*`. For example, key0LikeThis or KEY_1_LIKE_THIS. + // * The attribute values must be of the same type (text or number). * + // Only 1 value is allowed for each attribute. * For text values, the + // length limit is 256 UTF-8 characters. * The attribute does not + // support search. The `searchable` field should be unset or set to + // false. * The max summed total bytes of custom attribute keys and + // values per product is 5MiB. + Attributes map[string]GoogleCloudRetailV2CustomAttribute `json:"attributes,omitempty"` + + // FulfillmentTypes: Input only. Supported fulfillment types. Valid + // fulfillment type values include commonly used types (such as pickup + // in store and same day delivery), and custom types. Customers have to + // map custom types to their display names before rendering UI. + // Supported values: * "pickup-in-store" * "ship-to-store" * + // "same-day-delivery" * "next-day-delivery" * "custom-type-1" * + // "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" + // If this field is set to an invalid value other than these, an + // INVALID_ARGUMENT error is returned. All the elements must be + // distinct. Otherwise, an INVALID_ARGUMENT error is returned. + FulfillmentTypes []string `json:"fulfillmentTypes,omitempty"` + + // PlaceId: The place ID for the current set of inventory information. + PlaceId string `json:"placeId,omitempty"` + + // PriceInfo: Product price and cost information. Google Merchant Center + // property price (https://support.google.com/merchants/answer/6324371). + PriceInfo *GoogleCloudRetailV2PriceInfo `json:"priceInfo,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Attributes") 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. "Attributes") 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 *GoogleCloudRetailV2LocalInventory) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2LocalInventory + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2PredictRequest: Request message for Predict // method. type GoogleCloudRetailV2PredictRequest struct { @@ -2966,6 +3088,60 @@ func (s *GoogleCloudRetailV2RemoveFulfillmentPlacesRequest) MarshalJSON() ([]byt type GoogleCloudRetailV2RemoveFulfillmentPlacesResponse struct { } +// GoogleCloudRetailV2RemoveLocalInventoriesMetadata: Metadata related +// to the progress of the RemoveLocalInventories operation. Currently +// empty because there is no meaningful metadata populated from the +// RemoveLocalInventories method. +type GoogleCloudRetailV2RemoveLocalInventoriesMetadata struct { +} + +// GoogleCloudRetailV2RemoveLocalInventoriesRequest: Request message for +// RemoveLocalInventories method. +type GoogleCloudRetailV2RemoveLocalInventoriesRequest struct { + // AllowMissing: If set to true, and the Product is not found, the local + // inventory removal request will still be processed and retained for at + // most 1 day and processed once the Product is created. If set to + // false, a NOT_FOUND error is returned if the Product is not found. + AllowMissing bool `json:"allowMissing,omitempty"` + + // PlaceIds: Required. A list of place IDs to have their inventory + // deleted. At most 3000 place IDs are allowed per request. + PlaceIds []string `json:"placeIds,omitempty"` + + // RemoveTime: The time when the inventory deletions are issued. Used to + // prevent out-of-order updates and deletions on local inventory fields. + // If not provided, the internal system time will be used. + RemoveTime string `json:"removeTime,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AllowMissing") 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. "AllowMissing") 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 *GoogleCloudRetailV2RemoveLocalInventoriesRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2RemoveLocalInventoriesRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2RemoveLocalInventoriesResponse: Response of the +// RemoveLocalInventories API. Currently empty because there is no +// meaningful response populated from the RemoveLocalInventories method. +type GoogleCloudRetailV2RemoveLocalInventoriesResponse struct { +} + // GoogleCloudRetailV2SearchRequest: Request message for // SearchService.Search method. type GoogleCloudRetailV2SearchRequest struct { @@ -2996,10 +3172,11 @@ type GoogleCloudRetailV2SearchRequest struct { // filter syntax. CanonicalFilter string `json:"canonicalFilter,omitempty"` - // DynamicFacetSpec: The specification for dynamically generated facets. - // Notice that only textual facets can be dynamically generated. This - // feature requires additional allowlisting. Contact Retail Search - // support team if you are interested in using dynamic facet feature. + // DynamicFacetSpec: Deprecated. Refer to + // https://cloud.google.com/retail/docs/configs#dynamic to enable + // dynamic facets. Do not set this field. The specification for + // dynamically generated facets. Notice that only textual facets can be + // dynamically generated. DynamicFacetSpec *GoogleCloudRetailV2SearchRequestDynamicFacetSpec `json:"dynamicFacetSpec,omitempty"` // FacetSpecs: Facet specifications for faceted search. If empty, no @@ -4235,14 +4412,13 @@ type GoogleCloudRetailV2UserInfo struct { // UserEventService.CollectUserEvent. DirectUserRequest bool `json:"directUserRequest,omitempty"` - // IpAddress: The end user's IP address. Required for getting - // SearchResponse.sponsored_results. This field is used to extract + // IpAddress: The end user's IP address. This field is used to extract // location information for personalization. This field must be either // an IPv4 address (e.g. "104.133.9.80") or an IPv6 address (e.g. // "2001:0db8:85a3:0000:0000:8a2e:0370:7334"). Otherwise, an - // INVALID_ARGUMENT error is returned. This should not be set when using - // the JavaScript tag in UserEventService.CollectUserEvent or if - // direct_user_request is set. + // INVALID_ARGUMENT error is returned. This should not be set when: * + // setting SearchRequest.user_info. * using the JavaScript tag in + // UserEventService.CollectUserEvent or if direct_user_request is set. IpAddress string `json:"ipAddress,omitempty"` // UserAgent: User agent as included in the HTTP header. Required for @@ -4254,9 +4430,9 @@ type GoogleCloudRetailV2UserInfo struct { UserAgent string `json:"userAgent,omitempty"` // UserId: Highly recommended for logged-in users. Unique identifier for - // logged-in user, such as a user name. The field must be a UTF-8 - // encoded string with a length limit of 128 characters. Otherwise, an - // INVALID_ARGUMENT error is returned. + // logged-in user, such as a user name. Always use a hashed value for + // this ID. The field must be a UTF-8 encoded string with a length limit + // of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. UserId string `json:"userId,omitempty"` // ForceSendFields is a list of field names (e.g. "DirectUserRequest") @@ -4884,6 +5060,19 @@ type GoogleCloudRetailV2betaAddFulfillmentPlacesMetadata struct { type GoogleCloudRetailV2betaAddFulfillmentPlacesResponse struct { } +// GoogleCloudRetailV2betaAddLocalInventoriesMetadata: Metadata related +// to the progress of the AddLocalInventories operation. Currently empty +// because there is no meaningful metadata populated from the +// AddLocalInventories method. +type GoogleCloudRetailV2betaAddLocalInventoriesMetadata struct { +} + +// GoogleCloudRetailV2betaAddLocalInventoriesResponse: Response of the +// AddLocalInventories API. Currently empty because there is no +// meaningful response populated from the AddLocalInventories method. +type GoogleCloudRetailV2betaAddLocalInventoriesResponse struct { +} + // GoogleCloudRetailV2betaExportErrorsConfig: Configuration of // destination for Export related errors. type GoogleCloudRetailV2betaExportErrorsConfig struct { @@ -5307,6 +5496,19 @@ type GoogleCloudRetailV2betaRemoveFulfillmentPlacesMetadata struct { type GoogleCloudRetailV2betaRemoveFulfillmentPlacesResponse struct { } +// GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata: Metadata +// related to the progress of the RemoveLocalInventories operation. +// Currently empty because there is no meaningful metadata populated +// from the RemoveLocalInventories method. +type GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata struct { +} + +// GoogleCloudRetailV2betaRemoveLocalInventoriesResponse: Response of +// the RemoveLocalInventories API. Currently empty because there is no +// meaningful response populated from the RemoveLocalInventories method. +type GoogleCloudRetailV2betaRemoveLocalInventoriesResponse struct { +} + // GoogleCloudRetailV2betaSetInventoryMetadata: Metadata related to the // progress of the SetInventory operation. Currently empty because there // is no meaningful metadata populated from the SetInventory method. @@ -5569,9 +5771,8 @@ type ProjectsLocationsCatalogsCompleteQueryCall struct { // CompleteQuery: Completes the specified prefix with keyword // suggestions. This feature is only available for users who have Retail -// Search enabled. Please submit a form here -// (https://cloud.google.com/contact) to contact cloud sales if you are -// interested in using Retail Search. +// Search enabled. Please enable Retail Search on Cloud Console before +// using this feature. // // - catalog: Catalog for which the completion is performed. Full // resource name of catalog, such as @@ -5750,7 +5951,7 @@ func (c *ProjectsLocationsCatalogsCompleteQueryCall) Do(opts ...googleapi.CallOp } return ret, nil // { - // "description": "Completes the specified prefix with keyword suggestions. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + // "description": "Completes the specified prefix with keyword suggestions. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}:completeQuery", // "httpMethod": "GET", // "id": "retail.projects.locations.catalogs.completeQuery", @@ -6647,9 +6848,8 @@ type ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall struct { // processed downstream. As a consequence, when a response is returned, // the added place IDs are not immediately manifested in the Product // queried by GetProduct or ListProducts. This feature is only available -// for users who have Retail Search enabled. Please submit a form here -// (https://cloud.google.com/contact) to contact cloud sales if you are -// interested in using Retail Search. +// for users who have Retail Search enabled. Please enable Retail Search +// on Cloud Console before using this feature. // // - product: Full resource name of Product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -6754,7 +6954,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall) Do(o } return ret, nil // { - // "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + // "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addFulfillmentPlaces", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.addFulfillmentPlaces", @@ -6784,6 +6984,163 @@ func (c *ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall) Do(o } +// method id "retail.projects.locations.catalogs.branches.products.addLocalInventories": + +type ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall struct { + s *Service + product string + googlecloudretailv2addlocalinventoriesrequest *GoogleCloudRetailV2AddLocalInventoriesRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// AddLocalInventories: Updates local inventory information for a +// Product at a list of places, while respecting the last update +// timestamps of each inventory field. This process is asynchronous and +// does not require the Product to exist before updating inventory +// information. If the request is valid, the update will be enqueued and +// processed downstream. As a consequence, when a response is returned, +// updates are not immediately manifested in the Product queried by +// GetProduct or ListProducts. Local inventory information can only be +// modified using this method. CreateProduct and UpdateProduct has no +// effect on local inventories. This feature is only available for users +// who have Retail Search enabled. Please enable Retail Search on Cloud +// Console before using this feature. +// +// - product: Full resource name of Product, such as +// `projects/*/locations/global/catalogs/default_catalog/branches/defau +// lt_branch/products/some_product_id`. If the caller does not have +// permission to access the Product, regardless of whether or not it +// exists, a PERMISSION_DENIED error is returned. +func (r *ProjectsLocationsCatalogsBranchesProductsService) AddLocalInventories(product string, googlecloudretailv2addlocalinventoriesrequest *GoogleCloudRetailV2AddLocalInventoriesRequest) *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall { + c := &ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.product = product + c.googlecloudretailv2addlocalinventoriesrequest = googlecloudretailv2addlocalinventoriesrequest + 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 *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall { + 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 *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall) Context(ctx context.Context) *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall { + 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 *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall) 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.googlecloudretailv2addlocalinventoriesrequest) + 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, "v2/{+product}:addLocalInventories") + 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{ + "product": c.product, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "retail.projects.locations.catalogs.branches.products.addLocalInventories" 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 *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall) 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 local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be modified using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addLocalInventories", + // "httpMethod": "POST", + // "id": "retail.projects.locations.catalogs.branches.products.addLocalInventories", + // "parameterOrder": [ + // "product" + // ], + // "parameters": { + // "product": { + // "description": "Required. Full resource name of Product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/some_product_id`. If the caller does not have permission to access the Product, regardless of whether or not it exists, a PERMISSION_DENIED error is returned.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/branches/[^/]+/products/.*$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v2/{+product}:addLocalInventories", + // "request": { + // "$ref": "GoogleCloudRetailV2AddLocalInventoriesRequest" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "retail.projects.locations.catalogs.branches.products.create": type ProjectsLocationsCatalogsBranchesProductsCreateCall struct { @@ -7824,9 +8181,8 @@ type ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall struct // processed downstream. As a consequence, when a response is returned, // the removed place IDs are not immediately manifested in the Product // queried by GetProduct or ListProducts. This feature is only available -// for users who have Retail Search enabled. Please submit a form here -// (https://cloud.google.com/contact) to contact cloud sales if you are -// interested in using Retail Search. +// for users who have Retail Search enabled. Please enable Retail Search +// on Cloud Console before using this feature. // // - product: Full resource name of Product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -7931,7 +8287,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall) D } return ret, nil // { - // "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + // "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeFulfillmentPlaces", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.removeFulfillmentPlaces", @@ -7961,6 +8317,161 @@ func (c *ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall) D } +// method id "retail.projects.locations.catalogs.branches.products.removeLocalInventories": + +type ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall struct { + s *Service + product string + googlecloudretailv2removelocalinventoriesrequest *GoogleCloudRetailV2RemoveLocalInventoriesRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// RemoveLocalInventories: Remove local inventory information for a +// Product at a list of places at a removal timestamp. This process is +// asynchronous. If the request is valid, the removal will be enqueued +// and processed downstream. As a consequence, when a response is +// returned, removals are not immediately manifested in the Product +// queried by GetProduct or ListProducts. Local inventory information +// can only be removed using this method. CreateProduct and +// UpdateProduct has no effect on local inventories. This feature is +// only available for users who have Retail Search enabled. Please +// enable Retail Search on Cloud Console before using this feature. +// +// - product: Full resource name of Product, such as +// `projects/*/locations/global/catalogs/default_catalog/branches/defau +// lt_branch/products/some_product_id`. If the caller does not have +// permission to access the Product, regardless of whether or not it +// exists, a PERMISSION_DENIED error is returned. +func (r *ProjectsLocationsCatalogsBranchesProductsService) RemoveLocalInventories(product string, googlecloudretailv2removelocalinventoriesrequest *GoogleCloudRetailV2RemoveLocalInventoriesRequest) *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall { + c := &ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.product = product + c.googlecloudretailv2removelocalinventoriesrequest = googlecloudretailv2removelocalinventoriesrequest + 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 *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall { + 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 *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall) Context(ctx context.Context) *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall { + 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 *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall) 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.googlecloudretailv2removelocalinventoriesrequest) + 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, "v2/{+product}:removeLocalInventories") + 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{ + "product": c.product, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "retail.projects.locations.catalogs.branches.products.removeLocalInventories" 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 *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall) 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": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be removed using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeLocalInventories", + // "httpMethod": "POST", + // "id": "retail.projects.locations.catalogs.branches.products.removeLocalInventories", + // "parameterOrder": [ + // "product" + // ], + // "parameters": { + // "product": { + // "description": "Required. Full resource name of Product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/some_product_id`. If the caller does not have permission to access the Product, regardless of whether or not it exists, a PERMISSION_DENIED error is returned.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/branches/[^/]+/products/.*$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v2/{+product}:removeLocalInventories", + // "request": { + // "$ref": "GoogleCloudRetailV2RemoveLocalInventoriesRequest" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "retail.projects.locations.catalogs.branches.products.setInventory": type ProjectsLocationsCatalogsBranchesProductsSetInventoryCall struct { @@ -7991,8 +8502,7 @@ type ProjectsLocationsCatalogsBranchesProductsSetInventoryCall struct { // inventory information can only be updated with SetInventory, // AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature is // only available for users who have Retail Search enabled. Please -// submit a form here (https://cloud.google.com/contact) to contact -// cloud sales if you are interested in using Retail Search. +// enable Retail Search on Cloud Console before using this feature. // // - name: Immutable. Full resource name of the product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -8095,7 +8605,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsSetInventoryCall) Do(opts ...g } return ret, nil // { - // "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. When inventory is updated with CreateProduct and UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the CreateProduct or UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with SetInventory, AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + // "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. When inventory is updated with CreateProduct and UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the CreateProduct or UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with SetInventory, AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:setInventory", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.setInventory", @@ -8141,9 +8651,8 @@ type ProjectsLocationsCatalogsCompletionDataImportCall struct { // operation is successfully finished only after the imported // suggestions are indexed successfully and ready for serving. The // process takes hours. This feature is only available for users who -// have Retail Search enabled. Please submit a form here -// (https://cloud.google.com/contact) to contact cloud sales if you are -// interested in using Retail Search. +// have Retail Search enabled. Please enable Retail Search on Cloud +// Console before using this feature. // // - parent: The catalog which the suggestions dataset belongs to. // Format: `projects/1234/locations/global/catalogs/default_catalog`. @@ -8245,7 +8754,7 @@ func (c *ProjectsLocationsCatalogsCompletionDataImportCall) Do(opts ...googleapi } return ret, nil // { - // "description": "Bulk import of processed completion dataset. Request processing is asynchronous. Partial updating is not supported. The operation is successfully finished only after the imported suggestions are indexed successfully and ready for serving. The process takes hours. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + // "description": "Bulk import of processed completion dataset. Request processing is asynchronous. Partial updating is not supported. The operation is successfully finished only after the imported suggestions are indexed successfully and ready for serving. The process takes hours. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/completionData:import", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.completionData.import", @@ -8801,9 +9310,8 @@ type ProjectsLocationsCatalogsPlacementsSearchCall struct { } // Search: Performs a search. This feature is only available for users -// who have Retail Search enabled. Please submit a form here -// (https://cloud.google.com/contact) to contact cloud sales if you are -// interested in using Retail Search. +// who have Retail Search enabled. Please enable Retail Search on Cloud +// Console before using this feature. // // - placement: The resource name of the search engine placement, such // as @@ -8912,7 +9420,7 @@ func (c *ProjectsLocationsCatalogsPlacementsSearchCall) Do(opts ...googleapi.Cal } return ret, nil // { - // "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + // "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/placements/{placementsId}:search", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.placements.search", @@ -9127,9 +9635,8 @@ type ProjectsLocationsCatalogsServingConfigsSearchCall struct { } // Search: Performs a search. This feature is only available for users -// who have Retail Search enabled. Please submit a form here -// (https://cloud.google.com/contact) to contact cloud sales if you are -// interested in using Retail Search. +// who have Retail Search enabled. Please enable Retail Search on Cloud +// Console before using this feature. // // - placement: The resource name of the search engine placement, such // as @@ -9238,7 +9745,7 @@ func (c *ProjectsLocationsCatalogsServingConfigsSearchCall) Do(opts ...googleapi } return ret, nil // { - // "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + // "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/servingConfigs/{servingConfigsId}:search", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.servingConfigs.search", diff --git a/retail/v2alpha/retail-api.json b/retail/v2alpha/retail-api.json index 27222d3fd57..6cf16ef96f3 100644 --- a/retail/v2alpha/retail-api.json +++ b/retail/v2alpha/retail-api.json @@ -112,7 +112,7 @@ "catalogs": { "methods": { "completeQuery": { - "description": "Completes the specified prefix with keyword suggestions. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + "description": "Completes the specified prefix with keyword suggestions. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}:completeQuery", "httpMethod": "GET", "id": "retail.projects.locations.catalogs.completeQuery", @@ -533,7 +533,7 @@ "products": { "methods": { "addFulfillmentPlaces": { - "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addFulfillmentPlaces", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.addFulfillmentPlaces", @@ -561,7 +561,7 @@ ] }, "addLocalInventories": { - "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be modified using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact Cloud sales if you are interested in using Retail Search.", + "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be modified using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addLocalInventories", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.addLocalInventories", @@ -819,7 +819,7 @@ ] }, "removeFulfillmentPlaces": { - "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeFulfillmentPlaces", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.removeFulfillmentPlaces", @@ -847,7 +847,7 @@ ] }, "removeLocalInventories": { - "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be removed using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact Cloud sales if you are interested in using Retail Search.", + "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be removed using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeLocalInventories", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.removeLocalInventories", @@ -875,7 +875,7 @@ ] }, "setInventory": { - "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. When inventory is updated with CreateProduct and UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the CreateProduct or UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with SetInventory, AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. When inventory is updated with CreateProduct and UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the CreateProduct or UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with SetInventory, AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:setInventory", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.setInventory", @@ -909,7 +909,7 @@ "completionData": { "methods": { "import": { - "description": "Bulk import of processed completion dataset. Request processing is asynchronous. Partial updating is not supported. The operation is successfully finished only after the imported suggestions are indexed successfully and ready for serving. The process takes hours. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + "description": "Bulk import of processed completion dataset. Request processing is asynchronous. Partial updating is not supported. The operation is successfully finished only after the imported suggestions are indexed successfully and ready for serving. The process takes hours. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/completionData:import", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.completionData.import", @@ -1201,7 +1201,7 @@ ] }, "search": { - "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/placements/{placementsId}:search", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.placements.search", @@ -1470,7 +1470,7 @@ ] }, "search": { - "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/servingConfigs/{servingConfigsId}:search", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.servingConfigs.search", @@ -1803,7 +1803,7 @@ } } }, - "revision": "20220319", + "revision": "20220324", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -1968,6 +1968,18 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2AddLocalInventoriesMetadata": { + "description": "Metadata related to the progress of the AddLocalInventories operation. Currently empty because there is no meaningful metadata populated from the AddLocalInventories method.", + "id": "GoogleCloudRetailV2AddLocalInventoriesMetadata", + "properties": {}, + "type": "object" + }, + "GoogleCloudRetailV2AddLocalInventoriesResponse": { + "description": "Response of the AddLocalInventories API. Currently empty because there is no meaningful response populated from the AddLocalInventories method.", + "id": "GoogleCloudRetailV2AddLocalInventoriesResponse", + "properties": {}, + "type": "object" + }, "GoogleCloudRetailV2ImportCompletionDataResponse": { "description": "Response of the ImportCompletionDataRequest. If the long running operation is done, this message is returned by the google.longrunning.Operations.response field if the operation is successful.", "id": "GoogleCloudRetailV2ImportCompletionDataResponse", @@ -2116,6 +2128,18 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2RemoveLocalInventoriesMetadata": { + "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the RemoveLocalInventories method.", + "id": "GoogleCloudRetailV2RemoveLocalInventoriesMetadata", + "properties": {}, + "type": "object" + }, + "GoogleCloudRetailV2RemoveLocalInventoriesResponse": { + "description": "Response of the RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the RemoveLocalInventories method.", + "id": "GoogleCloudRetailV2RemoveLocalInventoriesResponse", + "properties": {}, + "type": "object" + }, "GoogleCloudRetailV2SetInventoryMetadata": { "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the SetInventory method.", "id": "GoogleCloudRetailV2SetInventoryMetadata", @@ -2982,7 +3006,7 @@ "enumDescriptions": [ "Defaults to INCREMENTAL.", "Inserts new products or updates existing products.", - "Calculates diff and replaces the entire product dataset. Existing products may be deleted if they are not present in the source location. Can only be set while using BigQuerySource. And the BigQuery dataset must be created in the data location \"us (multiple regions in United States)\", otherwise a PERMISSION_DENIED error is thrown. Add the IAM permission \"BigQuery Data Viewer\" for cloud-retail-customer-data-access@system.gserviceaccount.com before using this feature otherwise an error is thrown. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search." + "Calculates diff and replaces the entire product dataset. Existing products may be deleted if they are not present in the source location. Can only be set while using BigQuerySource. And the BigQuery dataset must be created in the data location \"us (multiple regions in United States)\", otherwise a PERMISSION_DENIED error is thrown. Add the IAM permission \"BigQuery Data Viewer\" for cloud-retail-customer-data-access@system.gserviceaccount.com before using this feature otherwise an error is thrown." ], "type": "string" }, @@ -3168,6 +3192,13 @@ "description": "Additional local inventory attributes, for example, store name, promotion tags, etc. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * At most 30 attributes are allowed. * The key must be a UTF-8 encoded string with a length limit of 32 characters. * The key must match the pattern: `a-zA-Z0-9*`. For example, key0LikeThis or KEY_1_LIKE_THIS. * The attribute values must be of the same type (text or number). * Only 1 value is allowed for each attribute. * For text values, the length limit is 256 UTF-8 characters. * The attribute does not support search. The `searchable` field should be unset or set to false. * The max summed total bytes of custom attribute keys and values per product is 5MiB.", "type": "object" }, + "fulfillmentTypes": { + "description": "Input only. Supported fulfillment types. Valid fulfillment type values include commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * \"pickup-in-store\" * \"ship-to-store\" * \"same-day-delivery\" * \"next-day-delivery\" * \"custom-type-1\" * \"custom-type-2\" * \"custom-type-3\" * \"custom-type-4\" * \"custom-type-5\" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. All the elements must be distinct. Otherwise, an INVALID_ARGUMENT error is returned.", + "items": { + "type": "string" + }, + "type": "array" + }, "placeId": { "description": "The place ID for the current set of inventory information.", "type": "string" @@ -3195,7 +3226,7 @@ "type": "array" }, "languageCode": { - "description": "Language of the title/description and other string attributes. Use language tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). ISO 639-1. This specifies the language of offers in Merchant Center that will be accepted. If empty no language filtering will be performed.", + "description": "Language of the title/description and other string attributes. Use language tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). ISO 639-1. This specifies the language of offers in Merchant Center that will be accepted. If empty no language filtering will be performed. Example value: `en`.", "type": "string" }, "merchantCenterAccountId": { @@ -4160,7 +4191,7 @@ }, "dynamicFacetSpec": { "$ref": "GoogleCloudRetailV2alphaSearchRequestDynamicFacetSpec", - "description": "The specification for dynamically generated facets. Notice that only textual facets can be dynamically generated. This feature requires additional allowlisting. Contact Retail Search support team if you are interested in using dynamic facet feature." + "description": "Deprecated. Refer to https://cloud.google.com/retail/docs/configs#dynamic to enable dynamic facets. Do not set this field. The specification for dynamically generated facets. Notice that only textual facets can be dynamically generated." }, "facetSpecs": { "description": "Facet specifications for faceted search. If empty, no facets are returned. A maximum of 100 values are allowed. Otherwise, an INVALID_ARGUMENT error is returned.", @@ -4919,7 +4950,7 @@ "type": "boolean" }, "ipAddress": { - "description": "The end user's IP address. Required for getting SearchResponse.sponsored_results. This field is used to extract location information for personalization. This field must be either an IPv4 address (e.g. \"104.133.9.80\") or an IPv6 address (e.g. \"2001:0db8:85a3:0000:0000:8a2e:0370:7334\"). Otherwise, an INVALID_ARGUMENT error is returned. This should not be set when using the JavaScript tag in UserEventService.CollectUserEvent or if direct_user_request is set.", + "description": "The end user's IP address. This field is used to extract location information for personalization. This field must be either an IPv4 address (e.g. \"104.133.9.80\") or an IPv6 address (e.g. \"2001:0db8:85a3:0000:0000:8a2e:0370:7334\"). Otherwise, an INVALID_ARGUMENT error is returned. This should not be set when: * setting SearchRequest.user_info. * using the JavaScript tag in UserEventService.CollectUserEvent or if direct_user_request is set.", "type": "string" }, "userAgent": { @@ -4927,7 +4958,7 @@ "type": "string" }, "userId": { - "description": "Highly recommended for logged-in users. Unique identifier for logged-in user, such as a user name. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", + "description": "Highly recommended for logged-in users. Unique identifier for logged-in user, such as a user name. Always use a hashed value for this ID. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", "type": "string" } }, @@ -4945,6 +4976,18 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2betaAddLocalInventoriesMetadata": { + "description": "Metadata related to the progress of the AddLocalInventories operation. Currently empty because there is no meaningful metadata populated from the AddLocalInventories method.", + "id": "GoogleCloudRetailV2betaAddLocalInventoriesMetadata", + "properties": {}, + "type": "object" + }, + "GoogleCloudRetailV2betaAddLocalInventoriesResponse": { + "description": "Response of the AddLocalInventories API. Currently empty because there is no meaningful response populated from the AddLocalInventories method.", + "id": "GoogleCloudRetailV2betaAddLocalInventoriesResponse", + "properties": {}, + "type": "object" + }, "GoogleCloudRetailV2betaExportErrorsConfig": { "description": "Configuration of destination for Export related errors.", "id": "GoogleCloudRetailV2betaExportErrorsConfig", @@ -5157,6 +5200,18 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata": { + "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the RemoveLocalInventories method.", + "id": "GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata", + "properties": {}, + "type": "object" + }, + "GoogleCloudRetailV2betaRemoveLocalInventoriesResponse": { + "description": "Response of the RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the RemoveLocalInventories method.", + "id": "GoogleCloudRetailV2betaRemoveLocalInventoriesResponse", + "properties": {}, + "type": "object" + }, "GoogleCloudRetailV2betaSetInventoryMetadata": { "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the SetInventory method.", "id": "GoogleCloudRetailV2betaSetInventoryMetadata", diff --git a/retail/v2alpha/retail-gen.go b/retail/v2alpha/retail-gen.go index 09ecb702569..9ea86c98922 100644 --- a/retail/v2alpha/retail-gen.go +++ b/retail/v2alpha/retail-gen.go @@ -619,6 +619,19 @@ type GoogleCloudRetailV2AddFulfillmentPlacesMetadata struct { type GoogleCloudRetailV2AddFulfillmentPlacesResponse struct { } +// GoogleCloudRetailV2AddLocalInventoriesMetadata: Metadata related to +// the progress of the AddLocalInventories operation. Currently empty +// because there is no meaningful metadata populated from the +// AddLocalInventories method. +type GoogleCloudRetailV2AddLocalInventoriesMetadata struct { +} + +// GoogleCloudRetailV2AddLocalInventoriesResponse: Response of the +// AddLocalInventories API. Currently empty because there is no +// meaningful response populated from the AddLocalInventories method. +type GoogleCloudRetailV2AddLocalInventoriesResponse struct { +} + // GoogleCloudRetailV2ImportCompletionDataResponse: Response of the // ImportCompletionDataRequest. If the long running operation is done, // this message is returned by the @@ -902,6 +915,19 @@ type GoogleCloudRetailV2RemoveFulfillmentPlacesMetadata struct { type GoogleCloudRetailV2RemoveFulfillmentPlacesResponse struct { } +// GoogleCloudRetailV2RemoveLocalInventoriesMetadata: Metadata related +// to the progress of the RemoveLocalInventories operation. Currently +// empty because there is no meaningful metadata populated from the +// RemoveLocalInventories method. +type GoogleCloudRetailV2RemoveLocalInventoriesMetadata struct { +} + +// GoogleCloudRetailV2RemoveLocalInventoriesResponse: Response of the +// RemoveLocalInventories API. Currently empty because there is no +// meaningful response populated from the RemoveLocalInventories method. +type GoogleCloudRetailV2RemoveLocalInventoriesResponse struct { +} + // GoogleCloudRetailV2SetInventoryMetadata: Metadata related to the // progress of the SetInventory operation. Currently empty because there // is no meaningful metadata populated from the SetInventory method. @@ -2556,10 +2582,7 @@ type GoogleCloudRetailV2alphaImportProductsRequest struct { // regions in United States)", otherwise a PERMISSION_DENIED error is // thrown. Add the IAM permission "BigQuery Data Viewer" for // cloud-retail-customer-data-access@system.gserviceaccount.com before - // using this feature otherwise an error is thrown. This feature is only - // available for users who have Retail Search enabled. Please submit a - // form [here](https://cloud.google.com/contact) to contact cloud sales - // if you are interested in using Retail Search. + // using this feature otherwise an error is thrown. ReconciliationMode string `json:"reconciliationMode,omitempty"` // RequestId: Deprecated. This field has no effect. @@ -2934,6 +2957,18 @@ type GoogleCloudRetailV2alphaLocalInventory struct { // values per product is 5MiB. Attributes map[string]GoogleCloudRetailV2alphaCustomAttribute `json:"attributes,omitempty"` + // FulfillmentTypes: Input only. Supported fulfillment types. Valid + // fulfillment type values include commonly used types (such as pickup + // in store and same day delivery), and custom types. Customers have to + // map custom types to their display names before rendering UI. + // Supported values: * "pickup-in-store" * "ship-to-store" * + // "same-day-delivery" * "next-day-delivery" * "custom-type-1" * + // "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" + // If this field is set to an invalid value other than these, an + // INVALID_ARGUMENT error is returned. All the elements must be + // distinct. Otherwise, an INVALID_ARGUMENT error is returned. + FulfillmentTypes []string `json:"fulfillmentTypes,omitempty"` + // PlaceId: The place ID for the current set of inventory information. PlaceId string `json:"placeId,omitempty"` @@ -2989,7 +3024,8 @@ type GoogleCloudRetailV2alphaMerchantCenterLink struct { // attributes. Use language tags defined by BCP 47 // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt). ISO 639-1. This // specifies the language of offers in Merchant Center that will be - // accepted. If empty no language filtering will be performed. + // accepted. If empty no language filtering will be performed. Example + // value: `en`. LanguageCode string `json:"languageCode,omitempty"` // MerchantCenterAccountId: Required. The linked Merchant center account @@ -4957,10 +4993,11 @@ type GoogleCloudRetailV2alphaSearchRequest struct { // filter syntax. CanonicalFilter string `json:"canonicalFilter,omitempty"` - // DynamicFacetSpec: The specification for dynamically generated facets. - // Notice that only textual facets can be dynamically generated. This - // feature requires additional allowlisting. Contact Retail Search - // support team if you are interested in using dynamic facet feature. + // DynamicFacetSpec: Deprecated. Refer to + // https://cloud.google.com/retail/docs/configs#dynamic to enable + // dynamic facets. Do not set this field. The specification for + // dynamically generated facets. Notice that only textual facets can be + // dynamically generated. DynamicFacetSpec *GoogleCloudRetailV2alphaSearchRequestDynamicFacetSpec `json:"dynamicFacetSpec,omitempty"` // FacetSpecs: Facet specifications for faceted search. If empty, no @@ -6378,14 +6415,13 @@ type GoogleCloudRetailV2alphaUserInfo struct { // UserEventService.CollectUserEvent. DirectUserRequest bool `json:"directUserRequest,omitempty"` - // IpAddress: The end user's IP address. Required for getting - // SearchResponse.sponsored_results. This field is used to extract + // IpAddress: The end user's IP address. This field is used to extract // location information for personalization. This field must be either // an IPv4 address (e.g. "104.133.9.80") or an IPv6 address (e.g. // "2001:0db8:85a3:0000:0000:8a2e:0370:7334"). Otherwise, an - // INVALID_ARGUMENT error is returned. This should not be set when using - // the JavaScript tag in UserEventService.CollectUserEvent or if - // direct_user_request is set. + // INVALID_ARGUMENT error is returned. This should not be set when: * + // setting SearchRequest.user_info. * using the JavaScript tag in + // UserEventService.CollectUserEvent or if direct_user_request is set. IpAddress string `json:"ipAddress,omitempty"` // UserAgent: User agent as included in the HTTP header. Required for @@ -6397,9 +6433,9 @@ type GoogleCloudRetailV2alphaUserInfo struct { UserAgent string `json:"userAgent,omitempty"` // UserId: Highly recommended for logged-in users. Unique identifier for - // logged-in user, such as a user name. The field must be a UTF-8 - // encoded string with a length limit of 128 characters. Otherwise, an - // INVALID_ARGUMENT error is returned. + // logged-in user, such as a user name. Always use a hashed value for + // this ID. The field must be a UTF-8 encoded string with a length limit + // of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. UserId string `json:"userId,omitempty"` // ForceSendFields is a list of field names (e.g. "DirectUserRequest") @@ -6439,6 +6475,19 @@ type GoogleCloudRetailV2betaAddFulfillmentPlacesMetadata struct { type GoogleCloudRetailV2betaAddFulfillmentPlacesResponse struct { } +// GoogleCloudRetailV2betaAddLocalInventoriesMetadata: Metadata related +// to the progress of the AddLocalInventories operation. Currently empty +// because there is no meaningful metadata populated from the +// AddLocalInventories method. +type GoogleCloudRetailV2betaAddLocalInventoriesMetadata struct { +} + +// GoogleCloudRetailV2betaAddLocalInventoriesResponse: Response of the +// AddLocalInventories API. Currently empty because there is no +// meaningful response populated from the AddLocalInventories method. +type GoogleCloudRetailV2betaAddLocalInventoriesResponse struct { +} + // GoogleCloudRetailV2betaExportErrorsConfig: Configuration of // destination for Export related errors. type GoogleCloudRetailV2betaExportErrorsConfig struct { @@ -6862,6 +6911,19 @@ type GoogleCloudRetailV2betaRemoveFulfillmentPlacesMetadata struct { type GoogleCloudRetailV2betaRemoveFulfillmentPlacesResponse struct { } +// GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata: Metadata +// related to the progress of the RemoveLocalInventories operation. +// Currently empty because there is no meaningful metadata populated +// from the RemoveLocalInventories method. +type GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata struct { +} + +// GoogleCloudRetailV2betaRemoveLocalInventoriesResponse: Response of +// the RemoveLocalInventories API. Currently empty because there is no +// meaningful response populated from the RemoveLocalInventories method. +type GoogleCloudRetailV2betaRemoveLocalInventoriesResponse struct { +} + // GoogleCloudRetailV2betaSetInventoryMetadata: Metadata related to the // progress of the SetInventory operation. Currently empty because there // is no meaningful metadata populated from the SetInventory method. @@ -7124,9 +7186,8 @@ type ProjectsLocationsCatalogsCompleteQueryCall struct { // CompleteQuery: Completes the specified prefix with keyword // suggestions. This feature is only available for users who have Retail -// Search enabled. Please submit a form here -// (https://cloud.google.com/contact) to contact cloud sales if you are -// interested in using Retail Search. +// Search enabled. Please enable Retail Search on Cloud Console before +// using this feature. // // - catalog: Catalog for which the completion is performed. Full // resource name of catalog, such as @@ -7305,7 +7366,7 @@ func (c *ProjectsLocationsCatalogsCompleteQueryCall) Do(opts ...googleapi.CallOp } return ret, nil // { - // "description": "Completes the specified prefix with keyword suggestions. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + // "description": "Completes the specified prefix with keyword suggestions. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}:completeQuery", // "httpMethod": "GET", // "id": "retail.projects.locations.catalogs.completeQuery", @@ -9278,9 +9339,8 @@ type ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall struct { // processed downstream. As a consequence, when a response is returned, // the added place IDs are not immediately manifested in the Product // queried by GetProduct or ListProducts. This feature is only available -// for users who have Retail Search enabled. Please submit a form here -// (https://cloud.google.com/contact) to contact cloud sales if you are -// interested in using Retail Search. +// for users who have Retail Search enabled. Please enable Retail Search +// on Cloud Console before using this feature. // // - product: Full resource name of Product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -9385,7 +9445,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall) Do(o } return ret, nil // { - // "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + // "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addFulfillmentPlaces", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.addFulfillmentPlaces", @@ -9436,9 +9496,8 @@ type ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall struct { // GetProduct or ListProducts. Local inventory information can only be // modified using this method. CreateProduct and UpdateProduct has no // effect on local inventories. This feature is only available for users -// who have Retail Search enabled. Please submit a form here -// (https://cloud.google.com/contact) to contact Cloud sales if you are -// interested in using Retail Search. +// who have Retail Search enabled. Please enable Retail Search on Cloud +// Console before using this feature. // // - product: Full resource name of Product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -9543,7 +9602,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall) Do(op } return ret, nil // { - // "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be modified using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact Cloud sales if you are interested in using Retail Search.", + // "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be modified using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addLocalInventories", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.addLocalInventories", @@ -10780,9 +10839,8 @@ type ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall struct // processed downstream. As a consequence, when a response is returned, // the removed place IDs are not immediately manifested in the Product // queried by GetProduct or ListProducts. This feature is only available -// for users who have Retail Search enabled. Please submit a form here -// (https://cloud.google.com/contact) to contact cloud sales if you are -// interested in using Retail Search. +// for users who have Retail Search enabled. Please enable Retail Search +// on Cloud Console before using this feature. // // - product: Full resource name of Product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -10887,7 +10945,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall) D } return ret, nil // { - // "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + // "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeFulfillmentPlaces", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.removeFulfillmentPlaces", @@ -10937,8 +10995,7 @@ type ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall struct // can only be removed using this method. CreateProduct and // UpdateProduct has no effect on local inventories. This feature is // only available for users who have Retail Search enabled. Please -// submit a form here (https://cloud.google.com/contact) to contact -// Cloud sales if you are interested in using Retail Search. +// enable Retail Search on Cloud Console before using this feature. // // - product: Full resource name of Product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -11043,7 +11100,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall) Do } return ret, nil // { - // "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be removed using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact Cloud sales if you are interested in using Retail Search.", + // "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be removed using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeLocalInventories", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.removeLocalInventories", @@ -11103,8 +11160,7 @@ type ProjectsLocationsCatalogsBranchesProductsSetInventoryCall struct { // inventory information can only be updated with SetInventory, // AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature is // only available for users who have Retail Search enabled. Please -// submit a form here (https://cloud.google.com/contact) to contact -// cloud sales if you are interested in using Retail Search. +// enable Retail Search on Cloud Console before using this feature. // // - name: Immutable. Full resource name of the product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -11207,7 +11263,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsSetInventoryCall) Do(opts ...g } return ret, nil // { - // "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. When inventory is updated with CreateProduct and UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the CreateProduct or UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with SetInventory, AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + // "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. When inventory is updated with CreateProduct and UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the CreateProduct or UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with SetInventory, AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:setInventory", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.setInventory", @@ -11253,9 +11309,8 @@ type ProjectsLocationsCatalogsCompletionDataImportCall struct { // operation is successfully finished only after the imported // suggestions are indexed successfully and ready for serving. The // process takes hours. This feature is only available for users who -// have Retail Search enabled. Please submit a form here -// (https://cloud.google.com/contact) to contact cloud sales if you are -// interested in using Retail Search. +// have Retail Search enabled. Please enable Retail Search on Cloud +// Console before using this feature. // // - parent: The catalog which the suggestions dataset belongs to. // Format: `projects/1234/locations/global/catalogs/default_catalog`. @@ -11357,7 +11412,7 @@ func (c *ProjectsLocationsCatalogsCompletionDataImportCall) Do(opts ...googleapi } return ret, nil // { - // "description": "Bulk import of processed completion dataset. Request processing is asynchronous. Partial updating is not supported. The operation is successfully finished only after the imported suggestions are indexed successfully and ready for serving. The process takes hours. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + // "description": "Bulk import of processed completion dataset. Request processing is asynchronous. Partial updating is not supported. The operation is successfully finished only after the imported suggestions are indexed successfully and ready for serving. The process takes hours. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/completionData:import", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.completionData.import", @@ -12727,9 +12782,8 @@ type ProjectsLocationsCatalogsPlacementsSearchCall struct { } // Search: Performs a search. This feature is only available for users -// who have Retail Search enabled. Please submit a form here -// (https://cloud.google.com/contact) to contact cloud sales if you are -// interested in using Retail Search. +// who have Retail Search enabled. Please enable Retail Search on Cloud +// Console before using this feature. // // - placement: The resource name of the search engine placement, such // as @@ -12838,7 +12892,7 @@ func (c *ProjectsLocationsCatalogsPlacementsSearchCall) Do(opts ...googleapi.Cal } return ret, nil // { - // "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + // "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/placements/{placementsId}:search", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.placements.search", @@ -14154,9 +14208,8 @@ type ProjectsLocationsCatalogsServingConfigsSearchCall struct { } // Search: Performs a search. This feature is only available for users -// who have Retail Search enabled. Please submit a form here -// (https://cloud.google.com/contact) to contact cloud sales if you are -// interested in using Retail Search. +// who have Retail Search enabled. Please enable Retail Search on Cloud +// Console before using this feature. // // - placement: The resource name of the search engine placement, such // as @@ -14265,7 +14318,7 @@ func (c *ProjectsLocationsCatalogsServingConfigsSearchCall) Do(opts ...googleapi } return ret, nil // { - // "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + // "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/servingConfigs/{servingConfigsId}:search", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.servingConfigs.search", diff --git a/retail/v2beta/retail-api.json b/retail/v2beta/retail-api.json index fe0a2370131..0e0f4e50ae4 100644 --- a/retail/v2beta/retail-api.json +++ b/retail/v2beta/retail-api.json @@ -112,7 +112,7 @@ "catalogs": { "methods": { "completeQuery": { - "description": "Completes the specified prefix with keyword suggestions. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + "description": "Completes the specified prefix with keyword suggestions. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}:completeQuery", "httpMethod": "GET", "id": "retail.projects.locations.catalogs.completeQuery", @@ -533,7 +533,7 @@ "products": { "methods": { "addFulfillmentPlaces": { - "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addFulfillmentPlaces", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.addFulfillmentPlaces", @@ -560,6 +560,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "addLocalInventories": { + "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be modified using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addLocalInventories", + "httpMethod": "POST", + "id": "retail.projects.locations.catalogs.branches.products.addLocalInventories", + "parameterOrder": [ + "product" + ], + "parameters": { + "product": { + "description": "Required. Full resource name of Product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/some_product_id`. If the caller does not have permission to access the Product, regardless of whether or not it exists, a PERMISSION_DENIED error is returned.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/branches/[^/]+/products/.*$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+product}:addLocalInventories", + "request": { + "$ref": "GoogleCloudRetailV2betaAddLocalInventoriesRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "create": { "description": "Creates a Product.", "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products", @@ -758,7 +786,7 @@ ] }, "removeFulfillmentPlaces": { - "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeFulfillmentPlaces", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.removeFulfillmentPlaces", @@ -785,8 +813,36 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "removeLocalInventories": { + "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be removed using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeLocalInventories", + "httpMethod": "POST", + "id": "retail.projects.locations.catalogs.branches.products.removeLocalInventories", + "parameterOrder": [ + "product" + ], + "parameters": { + "product": { + "description": "Required. Full resource name of Product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/some_product_id`. If the caller does not have permission to access the Product, regardless of whether or not it exists, a PERMISSION_DENIED error is returned.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/branches/[^/]+/products/.*$", + "required": true, + "type": "string" + } + }, + "path": "v2beta/{+product}:removeLocalInventories", + "request": { + "$ref": "GoogleCloudRetailV2betaRemoveLocalInventoriesRequest" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "setInventory": { - "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. When inventory is updated with CreateProduct and UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the CreateProduct or UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with SetInventory, AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. When inventory is updated with CreateProduct and UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the CreateProduct or UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with SetInventory, AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:setInventory", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.branches.products.setInventory", @@ -820,7 +876,7 @@ "completionData": { "methods": { "import": { - "description": "Bulk import of processed completion dataset. Request processing is asynchronous. Partial updating is not supported. The operation is successfully finished only after the imported suggestions are indexed successfully and ready for serving. The process takes hours. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + "description": "Bulk import of processed completion dataset. Request processing is asynchronous. Partial updating is not supported. The operation is successfully finished only after the imported suggestions are indexed successfully and ready for serving. The process takes hours. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/completionData:import", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.completionData.import", @@ -1112,7 +1168,7 @@ ] }, "search": { - "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/placements/{placementsId}:search", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.placements.search", @@ -1381,7 +1437,7 @@ ] }, "search": { - "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/servingConfigs/{servingConfigsId}:search", "httpMethod": "POST", "id": "retail.projects.locations.catalogs.servingConfigs.search", @@ -1714,7 +1770,7 @@ } } }, - "revision": "20220319", + "revision": "20220324", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -1879,6 +1935,18 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2AddLocalInventoriesMetadata": { + "description": "Metadata related to the progress of the AddLocalInventories operation. Currently empty because there is no meaningful metadata populated from the AddLocalInventories method.", + "id": "GoogleCloudRetailV2AddLocalInventoriesMetadata", + "properties": {}, + "type": "object" + }, + "GoogleCloudRetailV2AddLocalInventoriesResponse": { + "description": "Response of the AddLocalInventories API. Currently empty because there is no meaningful response populated from the AddLocalInventories method.", + "id": "GoogleCloudRetailV2AddLocalInventoriesResponse", + "properties": {}, + "type": "object" + }, "GoogleCloudRetailV2ImportCompletionDataResponse": { "description": "Response of the ImportCompletionDataRequest. If the long running operation is done, this message is returned by the google.longrunning.Operations.response field if the operation is successful.", "id": "GoogleCloudRetailV2ImportCompletionDataResponse", @@ -2027,6 +2095,18 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2RemoveLocalInventoriesMetadata": { + "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the RemoveLocalInventories method.", + "id": "GoogleCloudRetailV2RemoveLocalInventoriesMetadata", + "properties": {}, + "type": "object" + }, + "GoogleCloudRetailV2RemoveLocalInventoriesResponse": { + "description": "Response of the RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the RemoveLocalInventories method.", + "id": "GoogleCloudRetailV2RemoveLocalInventoriesResponse", + "properties": {}, + "type": "object" + }, "GoogleCloudRetailV2SetInventoryMetadata": { "description": "Metadata related to the progress of the SetInventory operation. Currently empty because there is no meaningful metadata populated from the SetInventory method.", "id": "GoogleCloudRetailV2SetInventoryMetadata", @@ -2440,6 +2520,46 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2betaAddLocalInventoriesMetadata": { + "description": "Metadata related to the progress of the AddLocalInventories operation. Currently empty because there is no meaningful metadata populated from the AddLocalInventories method.", + "id": "GoogleCloudRetailV2betaAddLocalInventoriesMetadata", + "properties": {}, + "type": "object" + }, + "GoogleCloudRetailV2betaAddLocalInventoriesRequest": { + "description": "Request message for AddLocalInventories method.", + "id": "GoogleCloudRetailV2betaAddLocalInventoriesRequest", + "properties": { + "addMask": { + "description": "Indicates which inventory fields in the provided list of LocalInventory to update. The field is updated to the provided value. If a field is set while the place does not have a previous local inventory, the local inventory at that store is created. If a field is set while the value of that field is not provided, the original field value, if it exists, is deleted. If the mask is not set or set with empty paths, all inventory fields will be updated. If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned and the entire update will be ignored.", + "format": "google-fieldmask", + "type": "string" + }, + "addTime": { + "description": "The time when the inventory updates are issued. Used to prevent out-of-order updates on local inventory fields. If not provided, the internal system time will be used.", + "format": "google-datetime", + "type": "string" + }, + "allowMissing": { + "description": "If set to true, and the Product is not found, the local inventory will still be processed and retained for at most 1 day and processed once the Product is created. If set to false, a NOT_FOUND error is returned if the Product is not found.", + "type": "boolean" + }, + "localInventories": { + "description": "Required. A list of inventory information at difference places. Each place is identified by its place ID. At most 3000 inventories are allowed per request.", + "items": { + "$ref": "GoogleCloudRetailV2betaLocalInventory" + }, + "type": "array" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2betaAddLocalInventoriesResponse": { + "description": "Response of the AddLocalInventories API. Currently empty because there is no meaningful response populated from the AddLocalInventories method.", + "id": "GoogleCloudRetailV2betaAddLocalInventoriesResponse", + "properties": {}, + "type": "object" + }, "GoogleCloudRetailV2betaAttributesConfig": { "description": "Catalog level attribute config.", "id": "GoogleCloudRetailV2betaAttributesConfig", @@ -3176,7 +3296,7 @@ "enumDescriptions": [ "Defaults to INCREMENTAL.", "Inserts new products or updates existing products.", - "Calculates diff and replaces the entire product dataset. Existing products may be deleted if they are not present in the source location. Can only be set while using BigQuerySource. And the BigQuery dataset must be created in the data location \"us (multiple regions in United States)\", otherwise a PERMISSION_DENIED error is thrown. Add the IAM permission \"BigQuery Data Viewer\" for cloud-retail-customer-data-access@system.gserviceaccount.com before using this feature otherwise an error is thrown. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search." + "Calculates diff and replaces the entire product dataset. Existing products may be deleted if they are not present in the source location. Can only be set while using BigQuerySource. And the BigQuery dataset must be created in the data location \"us (multiple regions in United States)\", otherwise a PERMISSION_DENIED error is thrown. Add the IAM permission \"BigQuery Data Viewer\" for cloud-retail-customer-data-access@system.gserviceaccount.com before using this feature otherwise an error is thrown." ], "type": "string" }, @@ -3346,6 +3466,35 @@ }, "type": "object" }, + "GoogleCloudRetailV2betaLocalInventory": { + "description": "The inventory information at a place (e.g. a store) identified by a place ID.", + "id": "GoogleCloudRetailV2betaLocalInventory", + "properties": { + "attributes": { + "additionalProperties": { + "$ref": "GoogleCloudRetailV2betaCustomAttribute" + }, + "description": "Additional local inventory attributes, for example, store name, promotion tags, etc. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * At most 30 attributes are allowed. * The key must be a UTF-8 encoded string with a length limit of 32 characters. * The key must match the pattern: `a-zA-Z0-9*`. For example, key0LikeThis or KEY_1_LIKE_THIS. * The attribute values must be of the same type (text or number). * Only 1 value is allowed for each attribute. * For text values, the length limit is 256 UTF-8 characters. * The attribute does not support search. The `searchable` field should be unset or set to false. * The max summed total bytes of custom attribute keys and values per product is 5MiB.", + "type": "object" + }, + "fulfillmentTypes": { + "description": "Input only. Supported fulfillment types. Valid fulfillment type values include commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * \"pickup-in-store\" * \"ship-to-store\" * \"same-day-delivery\" * \"next-day-delivery\" * \"custom-type-1\" * \"custom-type-2\" * \"custom-type-3\" * \"custom-type-4\" * \"custom-type-5\" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. All the elements must be distinct. Otherwise, an INVALID_ARGUMENT error is returned.", + "items": { + "type": "string" + }, + "type": "array" + }, + "placeId": { + "description": "The place ID for the current set of inventory information.", + "type": "string" + }, + "priceInfo": { + "$ref": "GoogleCloudRetailV2betaPriceInfo", + "description": "Product price and cost information. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371)." + } + }, + "type": "object" + }, "GoogleCloudRetailV2betaMerchantCenterLink": { "description": "Represents a link between a Merchant Center account and a branch. Once a link is established, products from the linked merchant center account will be streamed to the linked branch.", "id": "GoogleCloudRetailV2betaMerchantCenterLink", @@ -3362,7 +3511,7 @@ "type": "array" }, "languageCode": { - "description": "Language of the title/description and other string attributes. Use language tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). ISO 639-1. This specifies the language of offers in Merchant Center that will be accepted. If empty no language filtering will be performed.", + "description": "Language of the title/description and other string attributes. Use language tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). ISO 639-1. This specifies the language of offers in Merchant Center that will be accepted. If empty no language filtering will be performed. Example value: `en`.", "type": "string" }, "merchantCenterAccountId": { @@ -4010,6 +4159,41 @@ "properties": {}, "type": "object" }, + "GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata": { + "description": "Metadata related to the progress of the RemoveLocalInventories operation. Currently empty because there is no meaningful metadata populated from the RemoveLocalInventories method.", + "id": "GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata", + "properties": {}, + "type": "object" + }, + "GoogleCloudRetailV2betaRemoveLocalInventoriesRequest": { + "description": "Request message for RemoveLocalInventories method.", + "id": "GoogleCloudRetailV2betaRemoveLocalInventoriesRequest", + "properties": { + "allowMissing": { + "description": "If set to true, and the Product is not found, the local inventory removal request will still be processed and retained for at most 1 day and processed once the Product is created. If set to false, a NOT_FOUND error is returned if the Product is not found.", + "type": "boolean" + }, + "placeIds": { + "description": "Required. A list of place IDs to have their inventory deleted. At most 3000 place IDs are allowed per request.", + "items": { + "type": "string" + }, + "type": "array" + }, + "removeTime": { + "description": "The time when the inventory deletions are issued. Used to prevent out-of-order updates and deletions on local inventory fields. If not provided, the internal system time will be used.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "GoogleCloudRetailV2betaRemoveLocalInventoriesResponse": { + "description": "Response of the RemoveLocalInventories API. Currently empty because there is no meaningful response populated from the RemoveLocalInventories method.", + "id": "GoogleCloudRetailV2betaRemoveLocalInventoriesResponse", + "properties": {}, + "type": "object" + }, "GoogleCloudRetailV2betaReplaceCatalogAttributeRequest": { "description": "Request for CatalogService.ReplaceCatalogAttribute method.", "id": "GoogleCloudRetailV2betaReplaceCatalogAttributeRequest", @@ -4231,7 +4415,7 @@ }, "dynamicFacetSpec": { "$ref": "GoogleCloudRetailV2betaSearchRequestDynamicFacetSpec", - "description": "The specification for dynamically generated facets. Notice that only textual facets can be dynamically generated. This feature requires additional allowlisting. Contact Retail Search support team if you are interested in using dynamic facet feature." + "description": "Deprecated. Refer to https://cloud.google.com/retail/docs/configs#dynamic to enable dynamic facets. Do not set this field. The specification for dynamically generated facets. Notice that only textual facets can be dynamically generated." }, "facetSpecs": { "description": "Facet specifications for faceted search. If empty, no facets are returned. A maximum of 100 values are allowed. Otherwise, an INVALID_ARGUMENT error is returned.", @@ -4972,7 +5156,7 @@ "type": "boolean" }, "ipAddress": { - "description": "The end user's IP address. Required for getting SearchResponse.sponsored_results. This field is used to extract location information for personalization. This field must be either an IPv4 address (e.g. \"104.133.9.80\") or an IPv6 address (e.g. \"2001:0db8:85a3:0000:0000:8a2e:0370:7334\"). Otherwise, an INVALID_ARGUMENT error is returned. This should not be set when using the JavaScript tag in UserEventService.CollectUserEvent or if direct_user_request is set.", + "description": "The end user's IP address. This field is used to extract location information for personalization. This field must be either an IPv4 address (e.g. \"104.133.9.80\") or an IPv6 address (e.g. \"2001:0db8:85a3:0000:0000:8a2e:0370:7334\"). Otherwise, an INVALID_ARGUMENT error is returned. This should not be set when: * setting SearchRequest.user_info. * using the JavaScript tag in UserEventService.CollectUserEvent or if direct_user_request is set.", "type": "string" }, "userAgent": { @@ -4980,7 +5164,7 @@ "type": "string" }, "userId": { - "description": "Highly recommended for logged-in users. Unique identifier for logged-in user, such as a user name. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", + "description": "Highly recommended for logged-in users. Unique identifier for logged-in user, such as a user name. Always use a hashed value for this ID. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", "type": "string" } }, diff --git a/retail/v2beta/retail-gen.go b/retail/v2beta/retail-gen.go index 56336e64d11..5268404e536 100644 --- a/retail/v2beta/retail-gen.go +++ b/retail/v2beta/retail-gen.go @@ -619,6 +619,19 @@ type GoogleCloudRetailV2AddFulfillmentPlacesMetadata struct { type GoogleCloudRetailV2AddFulfillmentPlacesResponse struct { } +// GoogleCloudRetailV2AddLocalInventoriesMetadata: Metadata related to +// the progress of the AddLocalInventories operation. Currently empty +// because there is no meaningful metadata populated from the +// AddLocalInventories method. +type GoogleCloudRetailV2AddLocalInventoriesMetadata struct { +} + +// GoogleCloudRetailV2AddLocalInventoriesResponse: Response of the +// AddLocalInventories API. Currently empty because there is no +// meaningful response populated from the AddLocalInventories method. +type GoogleCloudRetailV2AddLocalInventoriesResponse struct { +} + // GoogleCloudRetailV2ImportCompletionDataResponse: Response of the // ImportCompletionDataRequest. If the long running operation is done, // this message is returned by the @@ -902,6 +915,19 @@ type GoogleCloudRetailV2RemoveFulfillmentPlacesMetadata struct { type GoogleCloudRetailV2RemoveFulfillmentPlacesResponse struct { } +// GoogleCloudRetailV2RemoveLocalInventoriesMetadata: Metadata related +// to the progress of the RemoveLocalInventories operation. Currently +// empty because there is no meaningful metadata populated from the +// RemoveLocalInventories method. +type GoogleCloudRetailV2RemoveLocalInventoriesMetadata struct { +} + +// GoogleCloudRetailV2RemoveLocalInventoriesResponse: Response of the +// RemoveLocalInventories API. Currently empty because there is no +// meaningful response populated from the RemoveLocalInventories method. +type GoogleCloudRetailV2RemoveLocalInventoriesResponse struct { +} + // GoogleCloudRetailV2SetInventoryMetadata: Metadata related to the // progress of the SetInventory operation. Currently empty because there // is no meaningful metadata populated from the SetInventory method. @@ -1670,6 +1696,72 @@ func (s *GoogleCloudRetailV2betaAddFulfillmentPlacesRequest) MarshalJSON() ([]by type GoogleCloudRetailV2betaAddFulfillmentPlacesResponse struct { } +// GoogleCloudRetailV2betaAddLocalInventoriesMetadata: Metadata related +// to the progress of the AddLocalInventories operation. Currently empty +// because there is no meaningful metadata populated from the +// AddLocalInventories method. +type GoogleCloudRetailV2betaAddLocalInventoriesMetadata struct { +} + +// GoogleCloudRetailV2betaAddLocalInventoriesRequest: Request message +// for AddLocalInventories method. +type GoogleCloudRetailV2betaAddLocalInventoriesRequest struct { + // AddMask: Indicates which inventory fields in the provided list of + // LocalInventory to update. The field is updated to the provided value. + // If a field is set while the place does not have a previous local + // inventory, the local inventory at that store is created. If a field + // is set while the value of that field is not provided, the original + // field value, if it exists, is deleted. If the mask is not set or set + // with empty paths, all inventory fields will be updated. If an + // unsupported or unknown field is provided, an INVALID_ARGUMENT error + // is returned and the entire update will be ignored. + AddMask string `json:"addMask,omitempty"` + + // AddTime: The time when the inventory updates are issued. Used to + // prevent out-of-order updates on local inventory fields. If not + // provided, the internal system time will be used. + AddTime string `json:"addTime,omitempty"` + + // AllowMissing: If set to true, and the Product is not found, the local + // inventory will still be processed and retained for at most 1 day and + // processed once the Product is created. If set to false, a NOT_FOUND + // error is returned if the Product is not found. + AllowMissing bool `json:"allowMissing,omitempty"` + + // LocalInventories: Required. A list of inventory information at + // difference places. Each place is identified by its place ID. At most + // 3000 inventories are allowed per request. + LocalInventories []*GoogleCloudRetailV2betaLocalInventory `json:"localInventories,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AddMask") 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. "AddMask") 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 *GoogleCloudRetailV2betaAddLocalInventoriesRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaAddLocalInventoriesRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2betaAddLocalInventoriesResponse: Response of the +// AddLocalInventories API. Currently empty because there is no +// meaningful response populated from the AddLocalInventories method. +type GoogleCloudRetailV2betaAddLocalInventoriesResponse struct { +} + // GoogleCloudRetailV2betaAttributesConfig: Catalog level attribute // config. type GoogleCloudRetailV2betaAttributesConfig struct { @@ -3077,10 +3169,7 @@ type GoogleCloudRetailV2betaImportProductsRequest struct { // regions in United States)", otherwise a PERMISSION_DENIED error is // thrown. Add the IAM permission "BigQuery Data Viewer" for // cloud-retail-customer-data-access@system.gserviceaccount.com before - // using this feature otherwise an error is thrown. This feature is only - // available for users who have Retail Search enabled. Please submit a - // form [here](https://cloud.google.com/contact) to contact cloud sales - // if you are interested in using Retail Search. + // using this feature otherwise an error is thrown. ReconciliationMode string `json:"reconciliationMode,omitempty"` // RequestId: Deprecated. This field has no effect. @@ -3431,6 +3520,65 @@ func (s *GoogleCloudRetailV2betaListServingConfigsResponse) MarshalJSON() ([]byt return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudRetailV2betaLocalInventory: The inventory information at a +// place (e.g. a store) identified by a place ID. +type GoogleCloudRetailV2betaLocalInventory struct { + // Attributes: Additional local inventory attributes, for example, store + // name, promotion tags, etc. This field needs to pass all below + // criteria, otherwise an INVALID_ARGUMENT error is returned: * At most + // 30 attributes are allowed. * The key must be a UTF-8 encoded string + // with a length limit of 32 characters. * The key must match the + // pattern: `a-zA-Z0-9*`. For example, key0LikeThis or KEY_1_LIKE_THIS. + // * The attribute values must be of the same type (text or number). * + // Only 1 value is allowed for each attribute. * For text values, the + // length limit is 256 UTF-8 characters. * The attribute does not + // support search. The `searchable` field should be unset or set to + // false. * The max summed total bytes of custom attribute keys and + // values per product is 5MiB. + Attributes map[string]GoogleCloudRetailV2betaCustomAttribute `json:"attributes,omitempty"` + + // FulfillmentTypes: Input only. Supported fulfillment types. Valid + // fulfillment type values include commonly used types (such as pickup + // in store and same day delivery), and custom types. Customers have to + // map custom types to their display names before rendering UI. + // Supported values: * "pickup-in-store" * "ship-to-store" * + // "same-day-delivery" * "next-day-delivery" * "custom-type-1" * + // "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" + // If this field is set to an invalid value other than these, an + // INVALID_ARGUMENT error is returned. All the elements must be + // distinct. Otherwise, an INVALID_ARGUMENT error is returned. + FulfillmentTypes []string `json:"fulfillmentTypes,omitempty"` + + // PlaceId: The place ID for the current set of inventory information. + PlaceId string `json:"placeId,omitempty"` + + // PriceInfo: Product price and cost information. Google Merchant Center + // property price (https://support.google.com/merchants/answer/6324371). + PriceInfo *GoogleCloudRetailV2betaPriceInfo `json:"priceInfo,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Attributes") 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. "Attributes") 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 *GoogleCloudRetailV2betaLocalInventory) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaLocalInventory + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudRetailV2betaMerchantCenterLink: Represents a link between // a Merchant Center account and a branch. Once a link is established, // products from the linked merchant center account will be streamed to @@ -3456,7 +3604,8 @@ type GoogleCloudRetailV2betaMerchantCenterLink struct { // attributes. Use language tags defined by BCP 47 // (https://www.rfc-editor.org/rfc/bcp/bcp47.txt). ISO 639-1. This // specifies the language of offers in Merchant Center that will be - // accepted. If empty no language filtering will be performed. + // accepted. If empty no language filtering will be performed. Example + // value: `en`. LanguageCode string `json:"languageCode,omitempty"` // MerchantCenterAccountId: Required. The linked Merchant center account @@ -4800,6 +4949,60 @@ func (s *GoogleCloudRetailV2betaRemoveFulfillmentPlacesRequest) MarshalJSON() ([ type GoogleCloudRetailV2betaRemoveFulfillmentPlacesResponse struct { } +// GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata: Metadata +// related to the progress of the RemoveLocalInventories operation. +// Currently empty because there is no meaningful metadata populated +// from the RemoveLocalInventories method. +type GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata struct { +} + +// GoogleCloudRetailV2betaRemoveLocalInventoriesRequest: Request message +// for RemoveLocalInventories method. +type GoogleCloudRetailV2betaRemoveLocalInventoriesRequest struct { + // AllowMissing: If set to true, and the Product is not found, the local + // inventory removal request will still be processed and retained for at + // most 1 day and processed once the Product is created. If set to + // false, a NOT_FOUND error is returned if the Product is not found. + AllowMissing bool `json:"allowMissing,omitempty"` + + // PlaceIds: Required. A list of place IDs to have their inventory + // deleted. At most 3000 place IDs are allowed per request. + PlaceIds []string `json:"placeIds,omitempty"` + + // RemoveTime: The time when the inventory deletions are issued. Used to + // prevent out-of-order updates and deletions on local inventory fields. + // If not provided, the internal system time will be used. + RemoveTime string `json:"removeTime,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AllowMissing") 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. "AllowMissing") 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 *GoogleCloudRetailV2betaRemoveLocalInventoriesRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRetailV2betaRemoveLocalInventoriesRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleCloudRetailV2betaRemoveLocalInventoriesResponse: Response of +// the RemoveLocalInventories API. Currently empty because there is no +// meaningful response populated from the RemoveLocalInventories method. +type GoogleCloudRetailV2betaRemoveLocalInventoriesResponse struct { +} + // GoogleCloudRetailV2betaReplaceCatalogAttributeRequest: Request for // CatalogService.ReplaceCatalogAttribute method. type GoogleCloudRetailV2betaReplaceCatalogAttributeRequest struct { @@ -5241,10 +5444,11 @@ type GoogleCloudRetailV2betaSearchRequest struct { // filter syntax. CanonicalFilter string `json:"canonicalFilter,omitempty"` - // DynamicFacetSpec: The specification for dynamically generated facets. - // Notice that only textual facets can be dynamically generated. This - // feature requires additional allowlisting. Contact Retail Search - // support team if you are interested in using dynamic facet feature. + // DynamicFacetSpec: Deprecated. Refer to + // https://cloud.google.com/retail/docs/configs#dynamic to enable + // dynamic facets. Do not set this field. The specification for + // dynamically generated facets. Notice that only textual facets can be + // dynamically generated. DynamicFacetSpec *GoogleCloudRetailV2betaSearchRequestDynamicFacetSpec `json:"dynamicFacetSpec,omitempty"` // FacetSpecs: Facet specifications for faceted search. If empty, no @@ -6646,14 +6850,13 @@ type GoogleCloudRetailV2betaUserInfo struct { // UserEventService.CollectUserEvent. DirectUserRequest bool `json:"directUserRequest,omitempty"` - // IpAddress: The end user's IP address. Required for getting - // SearchResponse.sponsored_results. This field is used to extract + // IpAddress: The end user's IP address. This field is used to extract // location information for personalization. This field must be either // an IPv4 address (e.g. "104.133.9.80") or an IPv6 address (e.g. // "2001:0db8:85a3:0000:0000:8a2e:0370:7334"). Otherwise, an - // INVALID_ARGUMENT error is returned. This should not be set when using - // the JavaScript tag in UserEventService.CollectUserEvent or if - // direct_user_request is set. + // INVALID_ARGUMENT error is returned. This should not be set when: * + // setting SearchRequest.user_info. * using the JavaScript tag in + // UserEventService.CollectUserEvent or if direct_user_request is set. IpAddress string `json:"ipAddress,omitempty"` // UserAgent: User agent as included in the HTTP header. Required for @@ -6665,9 +6868,9 @@ type GoogleCloudRetailV2betaUserInfo struct { UserAgent string `json:"userAgent,omitempty"` // UserId: Highly recommended for logged-in users. Unique identifier for - // logged-in user, such as a user name. The field must be a UTF-8 - // encoded string with a length limit of 128 characters. Otherwise, an - // INVALID_ARGUMENT error is returned. + // logged-in user, such as a user name. Always use a hashed value for + // this ID. The field must be a UTF-8 encoded string with a length limit + // of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. UserId string `json:"userId,omitempty"` // ForceSendFields is a list of field names (e.g. "DirectUserRequest") @@ -6908,9 +7111,8 @@ type ProjectsLocationsCatalogsCompleteQueryCall struct { // CompleteQuery: Completes the specified prefix with keyword // suggestions. This feature is only available for users who have Retail -// Search enabled. Please submit a form here -// (https://cloud.google.com/contact) to contact cloud sales if you are -// interested in using Retail Search. +// Search enabled. Please enable Retail Search on Cloud Console before +// using this feature. // // - catalog: Catalog for which the completion is performed. Full // resource name of catalog, such as @@ -7089,7 +7291,7 @@ func (c *ProjectsLocationsCatalogsCompleteQueryCall) Do(opts ...googleapi.CallOp } return ret, nil // { - // "description": "Completes the specified prefix with keyword suggestions. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + // "description": "Completes the specified prefix with keyword suggestions. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}:completeQuery", // "httpMethod": "GET", // "id": "retail.projects.locations.catalogs.completeQuery", @@ -9055,9 +9257,8 @@ type ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall struct { // processed downstream. As a consequence, when a response is returned, // the added place IDs are not immediately manifested in the Product // queried by GetProduct or ListProducts. This feature is only available -// for users who have Retail Search enabled. Please submit a form here -// (https://cloud.google.com/contact) to contact cloud sales if you are -// interested in using Retail Search. +// for users who have Retail Search enabled. Please enable Retail Search +// on Cloud Console before using this feature. // // - product: Full resource name of Product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -9162,7 +9363,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall) Do(o } return ret, nil // { - // "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + // "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addFulfillmentPlaces", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.addFulfillmentPlaces", @@ -9192,6 +9393,163 @@ func (c *ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall) Do(o } +// method id "retail.projects.locations.catalogs.branches.products.addLocalInventories": + +type ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall struct { + s *Service + product string + googlecloudretailv2betaaddlocalinventoriesrequest *GoogleCloudRetailV2betaAddLocalInventoriesRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// AddLocalInventories: Updates local inventory information for a +// Product at a list of places, while respecting the last update +// timestamps of each inventory field. This process is asynchronous and +// does not require the Product to exist before updating inventory +// information. If the request is valid, the update will be enqueued and +// processed downstream. As a consequence, when a response is returned, +// updates are not immediately manifested in the Product queried by +// GetProduct or ListProducts. Local inventory information can only be +// modified using this method. CreateProduct and UpdateProduct has no +// effect on local inventories. This feature is only available for users +// who have Retail Search enabled. Please enable Retail Search on Cloud +// Console before using this feature. +// +// - product: Full resource name of Product, such as +// `projects/*/locations/global/catalogs/default_catalog/branches/defau +// lt_branch/products/some_product_id`. If the caller does not have +// permission to access the Product, regardless of whether or not it +// exists, a PERMISSION_DENIED error is returned. +func (r *ProjectsLocationsCatalogsBranchesProductsService) AddLocalInventories(product string, googlecloudretailv2betaaddlocalinventoriesrequest *GoogleCloudRetailV2betaAddLocalInventoriesRequest) *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall { + c := &ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.product = product + c.googlecloudretailv2betaaddlocalinventoriesrequest = googlecloudretailv2betaaddlocalinventoriesrequest + 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 *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall { + 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 *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall) Context(ctx context.Context) *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall { + 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 *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall) 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.googlecloudretailv2betaaddlocalinventoriesrequest) + 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/{+product}:addLocalInventories") + 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{ + "product": c.product, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "retail.projects.locations.catalogs.branches.products.addLocalInventories" 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 *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall) 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 local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be modified using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + // "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addLocalInventories", + // "httpMethod": "POST", + // "id": "retail.projects.locations.catalogs.branches.products.addLocalInventories", + // "parameterOrder": [ + // "product" + // ], + // "parameters": { + // "product": { + // "description": "Required. Full resource name of Product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/some_product_id`. If the caller does not have permission to access the Product, regardless of whether or not it exists, a PERMISSION_DENIED error is returned.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/branches/[^/]+/products/.*$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v2beta/{+product}:addLocalInventories", + // "request": { + // "$ref": "GoogleCloudRetailV2betaAddLocalInventoriesRequest" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "retail.projects.locations.catalogs.branches.products.create": type ProjectsLocationsCatalogsBranchesProductsCreateCall struct { @@ -10233,9 +10591,8 @@ type ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall struct // processed downstream. As a consequence, when a response is returned, // the removed place IDs are not immediately manifested in the Product // queried by GetProduct or ListProducts. This feature is only available -// for users who have Retail Search enabled. Please submit a form here -// (https://cloud.google.com/contact) to contact cloud sales if you are -// interested in using Retail Search. +// for users who have Retail Search enabled. Please enable Retail Search +// on Cloud Console before using this feature. // // - product: Full resource name of Product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -10340,7 +10697,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall) D } return ret, nil // { - // "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + // "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by GetProduct or ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeFulfillmentPlaces", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.removeFulfillmentPlaces", @@ -10370,6 +10727,161 @@ func (c *ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall) D } +// method id "retail.projects.locations.catalogs.branches.products.removeLocalInventories": + +type ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall struct { + s *Service + product string + googlecloudretailv2betaremovelocalinventoriesrequest *GoogleCloudRetailV2betaRemoveLocalInventoriesRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// RemoveLocalInventories: Remove local inventory information for a +// Product at a list of places at a removal timestamp. This process is +// asynchronous. If the request is valid, the removal will be enqueued +// and processed downstream. As a consequence, when a response is +// returned, removals are not immediately manifested in the Product +// queried by GetProduct or ListProducts. Local inventory information +// can only be removed using this method. CreateProduct and +// UpdateProduct has no effect on local inventories. This feature is +// only available for users who have Retail Search enabled. Please +// enable Retail Search on Cloud Console before using this feature. +// +// - product: Full resource name of Product, such as +// `projects/*/locations/global/catalogs/default_catalog/branches/defau +// lt_branch/products/some_product_id`. If the caller does not have +// permission to access the Product, regardless of whether or not it +// exists, a PERMISSION_DENIED error is returned. +func (r *ProjectsLocationsCatalogsBranchesProductsService) RemoveLocalInventories(product string, googlecloudretailv2betaremovelocalinventoriesrequest *GoogleCloudRetailV2betaRemoveLocalInventoriesRequest) *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall { + c := &ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.product = product + c.googlecloudretailv2betaremovelocalinventoriesrequest = googlecloudretailv2betaremovelocalinventoriesrequest + 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 *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall { + 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 *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall) Context(ctx context.Context) *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall { + 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 *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall) 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.googlecloudretailv2betaremovelocalinventoriesrequest) + 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/{+product}:removeLocalInventories") + 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{ + "product": c.product, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "retail.projects.locations.catalogs.branches.products.removeLocalInventories" 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 *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall) 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": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by GetProduct or ListProducts. Local inventory information can only be removed using this method. CreateProduct and UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", + // "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeLocalInventories", + // "httpMethod": "POST", + // "id": "retail.projects.locations.catalogs.branches.products.removeLocalInventories", + // "parameterOrder": [ + // "product" + // ], + // "parameters": { + // "product": { + // "description": "Required. Full resource name of Product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/some_product_id`. If the caller does not have permission to access the Product, regardless of whether or not it exists, a PERMISSION_DENIED error is returned.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/branches/[^/]+/products/.*$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v2beta/{+product}:removeLocalInventories", + // "request": { + // "$ref": "GoogleCloudRetailV2betaRemoveLocalInventoriesRequest" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "retail.projects.locations.catalogs.branches.products.setInventory": type ProjectsLocationsCatalogsBranchesProductsSetInventoryCall struct { @@ -10400,8 +10912,7 @@ type ProjectsLocationsCatalogsBranchesProductsSetInventoryCall struct { // inventory information can only be updated with SetInventory, // AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature is // only available for users who have Retail Search enabled. Please -// submit a form here (https://cloud.google.com/contact) to contact -// cloud sales if you are interested in using Retail Search. +// enable Retail Search on Cloud Console before using this feature. // // - name: Immutable. Full resource name of the product, such as // `projects/*/locations/global/catalogs/default_catalog/branches/defau @@ -10504,7 +11015,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsSetInventoryCall) Do(opts ...g } return ret, nil // { - // "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. When inventory is updated with CreateProduct and UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the CreateProduct or UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with SetInventory, AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + // "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by GetProduct or ListProducts. When inventory is updated with CreateProduct and UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the CreateProduct or UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with SetInventory, AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:setInventory", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.branches.products.setInventory", @@ -10550,9 +11061,8 @@ type ProjectsLocationsCatalogsCompletionDataImportCall struct { // operation is successfully finished only after the imported // suggestions are indexed successfully and ready for serving. The // process takes hours. This feature is only available for users who -// have Retail Search enabled. Please submit a form here -// (https://cloud.google.com/contact) to contact cloud sales if you are -// interested in using Retail Search. +// have Retail Search enabled. Please enable Retail Search on Cloud +// Console before using this feature. // // - parent: The catalog which the suggestions dataset belongs to. // Format: `projects/1234/locations/global/catalogs/default_catalog`. @@ -10654,7 +11164,7 @@ func (c *ProjectsLocationsCatalogsCompletionDataImportCall) Do(opts ...googleapi } return ret, nil // { - // "description": "Bulk import of processed completion dataset. Request processing is asynchronous. Partial updating is not supported. The operation is successfully finished only after the imported suggestions are indexed successfully and ready for serving. The process takes hours. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + // "description": "Bulk import of processed completion dataset. Request processing is asynchronous. Partial updating is not supported. The operation is successfully finished only after the imported suggestions are indexed successfully and ready for serving. The process takes hours. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/completionData:import", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.completionData.import", @@ -12024,9 +12534,8 @@ type ProjectsLocationsCatalogsPlacementsSearchCall struct { } // Search: Performs a search. This feature is only available for users -// who have Retail Search enabled. Please submit a form here -// (https://cloud.google.com/contact) to contact cloud sales if you are -// interested in using Retail Search. +// who have Retail Search enabled. Please enable Retail Search on Cloud +// Console before using this feature. // // - placement: The resource name of the search engine placement, such // as @@ -12135,7 +12644,7 @@ func (c *ProjectsLocationsCatalogsPlacementsSearchCall) Do(opts ...googleapi.Cal } return ret, nil // { - // "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + // "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/placements/{placementsId}:search", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.placements.search", @@ -13451,9 +13960,8 @@ type ProjectsLocationsCatalogsServingConfigsSearchCall struct { } // Search: Performs a search. This feature is only available for users -// who have Retail Search enabled. Please submit a form here -// (https://cloud.google.com/contact) to contact cloud sales if you are -// interested in using Retail Search. +// who have Retail Search enabled. Please enable Retail Search on Cloud +// Console before using this feature. // // - placement: The resource name of the search engine placement, such // as @@ -13562,7 +14070,7 @@ func (c *ProjectsLocationsCatalogsServingConfigsSearchCall) Do(opts ...googleapi } return ret, nil // { - // "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please submit a form [here](https://cloud.google.com/contact) to contact cloud sales if you are interested in using Retail Search.", + // "description": "Performs a search. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.", // "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/servingConfigs/{servingConfigsId}:search", // "httpMethod": "POST", // "id": "retail.projects.locations.catalogs.servingConfigs.search", diff --git a/storage/v1/storage-api.json b/storage/v1/storage-api.json index 0493a62d15b..80345543880 100644 --- a/storage/v1/storage-api.json +++ b/storage/v1/storage-api.json @@ -26,7 +26,7 @@ "description": "Stores and retrieves potentially large, immutable data objects.", "discoveryVersion": "v1", "documentationLink": "https://developers.google.com/storage/docs/json_api/", - "etag": "\"3137353238303035303136333633393332333233\"", + "etag": "\"3133303835363638353739313239313939393935\"", "icons": { "x16": "https://www.google.com/images/icons/product/cloud_storage-16.png", "x32": "https://www.google.com/images/icons/product/cloud_storage-32.png" @@ -3235,7 +3235,7 @@ } } }, - "revision": "20220210", + "revision": "20220328", "rootUrl": "https://storage.googleapis.com/", "schemas": { "Bucket": { @@ -3314,19 +3314,6 @@ }, "type": "array" }, - "customPlacementConfig": { - "description": "The bucket's custom placement configuration for Custom Dual Regions.", - "properties": { - "dataLocations": { - "description": "The list of regional locations in which data is placed.", - "items": { - "type": "string" - }, - "type": "array" - } - }, - "type": "object" - }, "defaultEventBasedHold": { "description": "The default value for event-based hold on newly created objects in this bucket. Event-based hold is a way to retain objects indefinitely until an event occurs, signified by the hold's release. After being released, such objects will be subject to bucket-level retention (if any). One sample use case of this flag is for banks to hold loan documents for at least 3 years after loan is paid in full. Here, bucket-level retention is 3 years and the event is loan being paid in full. In this example, these objects will be held intact for any number of years until the event has occurred (event-based hold on the object is released) and then 3 more years after that. That means retention duration of the objects begins from the moment event-based hold transitioned from true to false. Objects under event-based hold cannot be deleted, overwritten or archived until the hold is removed.", "type": "boolean" diff --git a/storage/v1/storage-gen.go b/storage/v1/storage-gen.go index cb9cb3ef124..f1470a3a585 100644 --- a/storage/v1/storage-gen.go +++ b/storage/v1/storage-gen.go @@ -291,10 +291,6 @@ type Bucket struct { // configuration. Cors []*BucketCors `json:"cors,omitempty"` - // CustomPlacementConfig: The bucket's custom placement configuration - // for Custom Dual Regions. - CustomPlacementConfig *BucketCustomPlacementConfig `json:"customPlacementConfig,omitempty"` - // DefaultEventBasedHold: The default value for event-based hold on // newly created objects in this bucket. Event-based hold is a way to // retain objects indefinitely until an event occurs, signified by the @@ -542,36 +538,6 @@ func (s *BucketCors) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// BucketCustomPlacementConfig: The bucket's custom placement -// configuration for Custom Dual Regions. -type BucketCustomPlacementConfig struct { - // DataLocations: The list of regional locations in which data is - // placed. - DataLocations []string `json:"dataLocations,omitempty"` - - // ForceSendFields is a list of field names (e.g. "DataLocations") 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. "DataLocations") 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 *BucketCustomPlacementConfig) MarshalJSON() ([]byte, error) { - type NoMethod BucketCustomPlacementConfig - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // BucketEncryption: Encryption configuration for a bucket. type BucketEncryption struct { // DefaultKmsKeyName: A Cloud KMS key that will be used to encrypt diff --git a/testing/v1/testing-api.json b/testing/v1/testing-api.json index 3e8b27af7a7..8adf344c5e6 100644 --- a/testing/v1/testing-api.json +++ b/testing/v1/testing-api.json @@ -282,7 +282,7 @@ } } }, - "revision": "20220310", + "revision": "20220329", "rootUrl": "https://testing.googleapis.com/", "schemas": { "Account": { @@ -2052,7 +2052,7 @@ "id": "TestTargetsForShard", "properties": { "testTargets": { - "description": "Group of packages, classes, and/or test methods to be run for each shard. The targets need to be specified in AndroidJUnitRunner argument format. For example, \"package com.my.packages\" \"class com.my.package.MyClass\". The number of shard_test_targets must be greater than 0.", + "description": "Group of packages, classes, and/or test methods to be run for each shard. The targets need to be specified in AndroidJUnitRunner argument format. For example, \"package com.my.packages\" \"class com.my.package.MyClass\". The number of test_targets must be greater than 0.", "items": { "type": "string" }, diff --git a/testing/v1/testing-gen.go b/testing/v1/testing-gen.go index f6d2d4889b0..b8e6f5a1a01 100644 --- a/testing/v1/testing-gen.go +++ b/testing/v1/testing-gen.go @@ -2993,7 +2993,7 @@ type TestTargetsForShard struct { // run for each shard. The targets need to be specified in // AndroidJUnitRunner argument format. For example, "package // com.my.packages" "class com.my.package.MyClass". The number of - // shard_test_targets must be greater than 0. + // test_targets must be greater than 0. TestTargets []string `json:"testTargets,omitempty"` // ForceSendFields is a list of field names (e.g. "TestTargets") to diff --git a/vmmigration/v1/vmmigration-api.json b/vmmigration/v1/vmmigration-api.json index 305878d7447..05e1992e556 100644 --- a/vmmigration/v1/vmmigration-api.json +++ b/vmmigration/v1/vmmigration-api.json @@ -1886,7 +1886,7 @@ } } }, - "revision": "20220203", + "revision": "20220327", "rootUrl": "https://vmmigration.googleapis.com/", "schemas": { "AddGroupMigrationRequest": { @@ -1998,6 +1998,12 @@ "readOnly": true, "type": "string" }, + "endTime": { + "description": "Output only. The time the clone job was ended.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, "error": { "$ref": "Status", "description": "Output only. Provides details for the errors that led to the Clone Job's state.", @@ -2350,6 +2356,12 @@ "readOnly": true, "type": "string" }, + "endTime": { + "description": "Output only. The time the cutover job had finished.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, "error": { "$ref": "Status", "description": "Output only. Provides details for the errors that led to the Cutover Job's state.", @@ -2497,7 +2509,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/vmmigration/v1/vmmigration-gen.go b/vmmigration/v1/vmmigration-gen.go index 08beff6acc9..6180e554b1a 100644 --- a/vmmigration/v1/vmmigration-gen.go +++ b/vmmigration/v1/vmmigration-gen.go @@ -441,6 +441,9 @@ type CloneJob struct { // API call, not when it was actually created in the target). CreateTime string `json:"createTime,omitempty"` + // EndTime: Output only. The time the clone job was ended. + EndTime string `json:"endTime,omitempty"` + // Error: Output only. Provides details for the errors that led to the // Clone Job's state. Error *Status `json:"error,omitempty"` @@ -782,6 +785,9 @@ type CutoverJob struct { // API call, not when it was actually created in the target). CreateTime string `json:"createTime,omitempty"` + // EndTime: Output only. The time the cutover job had finished. + EndTime string `json:"endTime,omitempty"` + // Error: Output only. Provides details for the errors that led to the // Cutover Job's state. Error *Status `json:"error,omitempty"` @@ -953,8 +959,7 @@ func (s *DatacenterConnector) 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. From a897ca4c166fabdef254d08fbbc5fe6ee86da498 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Fri, 1 Apr 2022 06:58:57 -0700 Subject: [PATCH 02/17] feat(all): auto-regenerate discovery clients (#1498) --- adsense/v2/adsense-api.json | 36 +- adsense/v2/adsense-gen.go | 21 + .../v1/androidmanagement-api.json | 6 +- androidmanagement/v1/androidmanagement-gen.go | 7 +- apikeys/v2/apikeys-api.json | 4 +- apikeys/v2/apikeys-gen.go | 5 +- appengine/v1/appengine-api.json | 8 +- appengine/v1/appengine-gen.go | 7 +- appengine/v1alpha/appengine-api.json | 4 +- appengine/v1alpha/appengine-gen.go | 3 +- appengine/v1beta/appengine-api.json | 10 +- appengine/v1beta/appengine-gen.go | 12 +- artifactregistry/v1/artifactregistry-api.json | 213 +- artifactregistry/v1/artifactregistry-gen.go | 308 ++- .../v1beta1/artifactregistry-api.json | 10 +- .../v1beta1/artifactregistry-gen.go | 8 +- .../v1beta2/artifactregistry-api.json | 22 +- .../v1beta2/artifactregistry-gen.go | 18 +- chat/v1/chat-api.json | 110 +- chat/v1/chat-gen.go | 193 +- cloudtasks/v2/cloudtasks-api.json | 4 +- cloudtasks/v2/cloudtasks-gen.go | 3 +- cloudtasks/v2beta2/cloudtasks-api.json | 4 +- cloudtasks/v2beta2/cloudtasks-gen.go | 3 +- cloudtasks/v2beta3/cloudtasks-api.json | 4 +- cloudtasks/v2beta3/cloudtasks-gen.go | 3 +- documentai/v1/documentai-api.json | 10 +- documentai/v1/documentai-gen.go | 10 +- documentai/v1beta2/documentai-api.json | 4 +- documentai/v1beta2/documentai-gen.go | 4 +- documentai/v1beta3/documentai-api.json | 10 +- documentai/v1beta3/documentai-gen.go | 10 +- firebaserules/v1/firebaserules-api.json | 4 +- firebaserules/v1/firebaserules-gen.go | 3 +- forms/v1/forms-api.json | 47 +- forms/v1/forms-gen.go | 50 +- iam/v1/iam-api.json | 4 +- iam/v1/iam-gen.go | 3 +- lifesciences/v2beta/lifesciences-api.json | 4 +- lifesciences/v2beta/lifesciences-gen.go | 3 +- monitoring/v1/monitoring-api.json | 48 +- monitoring/v1/monitoring-gen.go | 53 + recommender/v1/recommender-api.json | 376 +--- recommender/v1/recommender-gen.go | 1778 ++--------------- 44 files changed, 1177 insertions(+), 2270 deletions(-) diff --git a/adsense/v2/adsense-api.json b/adsense/v2/adsense-api.json index bd12726ca3e..96fcef36c03 100644 --- a/adsense/v2/adsense-api.json +++ b/adsense/v2/adsense-api.json @@ -1567,7 +1567,7 @@ } } }, - "revision": "20220319", + "revision": "20220330", "rootUrl": "https://adsense.googleapis.com/", "schemas": { "Account": { @@ -1602,6 +1602,23 @@ "readOnly": true, "type": "boolean" }, + "state": { + "description": "Output only. State of the account.", + "enum": [ + "STATE_UNSPECIFIED", + "READY", + "NEEDS_ATTENTION", + "CLOSED" + ], + "enumDescriptions": [ + "State unspecified.", + "The account is open and ready to serve ads.", + "There are some issues with this account. Publishers should visit AdSense in order to fix the account.", + "The account is closed and can't serve ads." + ], + "readOnly": true, + "type": "string" + }, "timeZone": { "$ref": "TimeZone", "description": "The account time zone, as used by reporting. For more information, see [changing the time zone of your reports](https://support.google.com/adsense/answer/9830725)." @@ -1626,6 +1643,23 @@ "description": "Output only. Unique ID of the ad client as used in the `AD_CLIENT_ID` reporting dimension. Present only if the ad client supports reporting.", "readOnly": true, "type": "string" + }, + "state": { + "description": "Output only. State of the ad client.", + "enum": [ + "STATE_UNSPECIFIED", + "READY", + "GETTING_READY", + "REQUIRES_REVIEW" + ], + "enumDescriptions": [ + "State unspecified.", + "The ad client is ready to show ads.", + "Running some checks on the ad client before it is ready to serve ads.", + "The ad client hasn't been checked yet. There are tasks pending before AdSense will start the review." + ], + "readOnly": true, + "type": "string" } }, "type": "object" diff --git a/adsense/v2/adsense-gen.go b/adsense/v2/adsense-gen.go index 5c4d3be5973..15cb387231f 100644 --- a/adsense/v2/adsense-gen.go +++ b/adsense/v2/adsense-gen.go @@ -280,6 +280,16 @@ type Account struct { // Premium: Output only. Whether this account is premium. Premium bool `json:"premium,omitempty"` + // State: Output only. State of the account. + // + // Possible values: + // "STATE_UNSPECIFIED" - State unspecified. + // "READY" - The account is open and ready to serve ads. + // "NEEDS_ATTENTION" - There are some issues with this account. + // Publishers should visit AdSense in order to fix the account. + // "CLOSED" - The account is closed and can't serve ads. + State string `json:"state,omitempty"` + // TimeZone: The account time zone, as used by reporting. For more // information, see changing the time zone of your reports // (https://support.google.com/adsense/answer/9830725). @@ -328,6 +338,17 @@ type AdClient struct { // client supports reporting. ReportingDimensionId string `json:"reportingDimensionId,omitempty"` + // State: Output only. State of the ad client. + // + // Possible values: + // "STATE_UNSPECIFIED" - State unspecified. + // "READY" - The ad client is ready to show ads. + // "GETTING_READY" - Running some checks on the ad client before it is + // ready to serve ads. + // "REQUIRES_REVIEW" - The ad client hasn't been checked yet. There + // are tasks pending before AdSense will start the review. + State string `json:"state,omitempty"` + // ForceSendFields is a list of field names (e.g. "Name") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any diff --git a/androidmanagement/v1/androidmanagement-api.json b/androidmanagement/v1/androidmanagement-api.json index 856c42ef168..fe6406d00e8 100644 --- a/androidmanagement/v1/androidmanagement-api.json +++ b/androidmanagement/v1/androidmanagement-api.json @@ -1004,7 +1004,7 @@ } } }, - "revision": "20220314", + "revision": "20220330", "rootUrl": "https://androidmanagement.googleapis.com/", "schemas": { "AdvancedSecurityOverrides": { @@ -2270,7 +2270,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" @@ -3849,7 +3849,7 @@ }, "permittedAccessibilityServices": { "$ref": "PackageNameList", - "description": "Specifies permitted accessibility services. If the field is not set, any accessibility service can be used. If the field is set, only the accessibility services in this list and the system's built-in accessibility service can be used. In particular, if the field is set to empty, only the system's built-in accessibility servicess can be used." + "description": "Specifies permitted accessibility services. If the field is not set, any accessibility service can be used. If the field is set, only the accessibility services in this list and the system's built-in accessibility service can be used. In particular, if the field is set to empty, only the system's built-in accessibility servicess can be used. This can be set on fully managed devices and on work profiles. When applied to a work profile, this affects both the personal profile and the work profile." }, "permittedInputMethods": { "$ref": "PackageNameList", diff --git a/androidmanagement/v1/androidmanagement-gen.go b/androidmanagement/v1/androidmanagement-gen.go index 34aed525434..61ba7ab1690 100644 --- a/androidmanagement/v1/androidmanagement-gen.go +++ b/androidmanagement/v1/androidmanagement-gen.go @@ -1840,8 +1840,7 @@ func (s *Display) 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. @@ -3961,7 +3960,9 @@ type Policy struct { // used. If the field is set, only the accessibility services in this // list and the system's built-in accessibility service can be used. In // particular, if the field is set to empty, only the system's built-in - // accessibility servicess can be used. + // accessibility servicess can be used. This can be set on fully managed + // devices and on work profiles. When applied to a work profile, this + // affects both the personal profile and the work profile. PermittedAccessibilityServices *PackageNameList `json:"permittedAccessibilityServices,omitempty"` // PermittedInputMethods: If present, only the input methods provided by diff --git a/apikeys/v2/apikeys-api.json b/apikeys/v2/apikeys-api.json index 151c59bea43..d1794634074 100644 --- a/apikeys/v2/apikeys-api.json +++ b/apikeys/v2/apikeys-api.json @@ -346,7 +346,7 @@ "type": "string" }, "showDeleted": { - "description": "Optional. Indicate that keys are marked as deleted within 30 days should also be returned. Normally only active keys are returned.", + "description": "Optional. Indicate that keys deleted in the past 30 days should also be returned.", "location": "query", "type": "boolean" } @@ -429,7 +429,7 @@ } } }, - "revision": "20220321", + "revision": "20220330", "rootUrl": "https://apikeys.googleapis.com/", "schemas": { "Operation": { diff --git a/apikeys/v2/apikeys-gen.go b/apikeys/v2/apikeys-gen.go index b429cff8fe3..b79880ef854 100644 --- a/apikeys/v2/apikeys-gen.go +++ b/apikeys/v2/apikeys-gen.go @@ -1868,8 +1868,7 @@ func (c *ProjectsLocationsKeysListCall) PageToken(pageToken string) *ProjectsLoc } // ShowDeleted sets the optional parameter "showDeleted": Indicate that -// keys are marked as deleted within 30 days should also be returned. -// Normally only active keys are returned. +// keys deleted in the past 30 days should also be returned. func (c *ProjectsLocationsKeysListCall) ShowDeleted(showDeleted bool) *ProjectsLocationsKeysListCall { c.urlParams_.Set("showDeleted", fmt.Sprint(showDeleted)) return c @@ -2006,7 +2005,7 @@ func (c *ProjectsLocationsKeysListCall) Do(opts ...googleapi.CallOption) (*V2Lis // "type": "string" // }, // "showDeleted": { - // "description": "Optional. Indicate that keys are marked as deleted within 30 days should also be returned. Normally only active keys are returned.", + // "description": "Optional. Indicate that keys deleted in the past 30 days should also be returned.", // "location": "query", // "type": "boolean" // } diff --git a/appengine/v1/appengine-api.json b/appengine/v1/appengine-api.json index 3f65fe4132c..d60521dd6b4 100644 --- a/appengine/v1/appengine-api.json +++ b/appengine/v1/appengine-api.json @@ -1595,7 +1595,7 @@ } } }, - "revision": "20211016", + "revision": "20220326", "rootUrl": "https://appengine.googleapis.com/", "schemas": { "ApiConfigHandler": { @@ -2127,7 +2127,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" @@ -3482,6 +3482,10 @@ "$ref": "ApiConfigHandler", "description": "Serving configuration for Google Cloud Endpoints (https://cloud.google.com/appengine/docs/python/endpoints/).Only returned in GET requests if view=FULL is set." }, + "appEngineApis": { + "description": "app_engine_apis allows second generation runtimes to access the App Engine APIs.", + "type": "boolean" + }, "automaticScaling": { "$ref": "AutomaticScaling", "description": "Automatic scaling is based on request rate, response latencies, and other application metrics. Instances are dynamically created and destroyed as needed in order to handle traffic." diff --git a/appengine/v1/appengine-gen.go b/appengine/v1/appengine-gen.go index ac3a464324e..5a2eace9dbb 100644 --- a/appengine/v1/appengine-gen.go +++ b/appengine/v1/appengine-gen.go @@ -1220,8 +1220,7 @@ func (s *DomainMapping) 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. @@ -3467,6 +3466,10 @@ type Version struct { // returned in GET requests if view=FULL is set. ApiConfig *ApiConfigHandler `json:"apiConfig,omitempty"` + // AppEngineApis: app_engine_apis allows second generation runtimes to + // access the App Engine APIs. + AppEngineApis bool `json:"appEngineApis,omitempty"` + // AutomaticScaling: Automatic scaling is based on request rate, // response latencies, and other application metrics. Instances are // dynamically created and destroyed as needed in order to handle diff --git a/appengine/v1alpha/appengine-api.json b/appengine/v1alpha/appengine-api.json index e3dbac110ae..cb1795bae77 100644 --- a/appengine/v1alpha/appengine-api.json +++ b/appengine/v1alpha/appengine-api.json @@ -887,7 +887,7 @@ } } }, - "revision": "20211029", + "revision": "20220326", "rootUrl": "https://appengine.googleapis.com/", "schemas": { "AuthorizedCertificate": { @@ -1031,7 +1031,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/appengine/v1alpha/appengine-gen.go b/appengine/v1alpha/appengine-gen.go index 56ee9536fa6..28f5d0163b0 100644 --- a/appengine/v1alpha/appengine-gen.go +++ b/appengine/v1alpha/appengine-gen.go @@ -559,8 +559,7 @@ func (s *DomainMapping) 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. diff --git a/appengine/v1beta/appengine-api.json b/appengine/v1beta/appengine-api.json index 376ff891bfe..db949cbf6f8 100644 --- a/appengine/v1beta/appengine-api.json +++ b/appengine/v1beta/appengine-api.json @@ -1595,7 +1595,7 @@ } } }, - "revision": "20211016", + "revision": "20220326", "rootUrl": "https://appengine.googleapis.com/", "schemas": { "ApiConfigHandler": { @@ -2178,7 +2178,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" @@ -2871,9 +2871,9 @@ "INTERNAL" ], "enumDescriptions": [ - "Unspecified should be treated as EXTERNAL", - "VMs should be created with external and internal IPs", - "VMs should be created with internal IPs only" + "Unspecified is treated as EXTERNAL.", + "Instances are created with both internal and external IP addresses.", + "Instances are created with internal IP addresses only." ], "type": "string" }, diff --git a/appengine/v1beta/appengine-gen.go b/appengine/v1beta/appengine-gen.go index 4c48c9d7c7e..44ceeccdf41 100644 --- a/appengine/v1beta/appengine-gen.go +++ b/appengine/v1beta/appengine-gen.go @@ -1317,8 +1317,7 @@ func (s *DomainMapping) 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. @@ -2489,10 +2488,11 @@ type Network struct { // Engine flexible environment. // // Possible values: - // "INSTANCE_IP_MODE_UNSPECIFIED" - Unspecified should be treated as - // EXTERNAL - // "EXTERNAL" - VMs should be created with external and internal IPs - // "INTERNAL" - VMs should be created with internal IPs only + // "INSTANCE_IP_MODE_UNSPECIFIED" - Unspecified is treated as + // EXTERNAL. + // "EXTERNAL" - Instances are created with both internal and external + // IP addresses. + // "INTERNAL" - Instances are created with internal IP addresses only. InstanceIpMode string `json:"instanceIpMode,omitempty"` // InstanceTag: Tag to apply to the instance during creation. Only diff --git a/artifactregistry/v1/artifactregistry-api.json b/artifactregistry/v1/artifactregistry-api.json index dec639c6ea4..b1fddd81c6a 100644 --- a/artifactregistry/v1/artifactregistry-api.json +++ b/artifactregistry/v1/artifactregistry-api.json @@ -1207,9 +1207,57 @@ } } }, - "revision": "20220311", + "revision": "20220328", "rootUrl": "https://artifactregistry.googleapis.com/", "schemas": { + "AptArtifact": { + "description": "A detailed representation of an Apt artifact. Information in the record is derived from the archive's control file. See https://www.debian.org/doc/debian-policy/ch-controlfields.html", + "id": "AptArtifact", + "properties": { + "architecture": { + "description": "Output only. Operating system architecture of the artifact.", + "readOnly": true, + "type": "string" + }, + "component": { + "description": "Output only. Repository component of the artifact.", + "readOnly": true, + "type": "string" + }, + "controlFile": { + "description": "Output only. Contents of the artifact's control metadata file.", + "format": "byte", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Output only. The Artifact Registry resource name of the artifact.", + "readOnly": true, + "type": "string" + }, + "packageName": { + "description": "Output only. The Apt package name of the artifact.", + "readOnly": true, + "type": "string" + }, + "packageType": { + "description": "Output only. An artifact is a binary or source package.", + "enum": [ + "PACKAGE_TYPE_UNSPECIFIED", + "BINARY", + "SOURCE" + ], + "enumDescriptions": [ + "Package type is not specified.", + "Binary package.", + "Source package." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "Binding": { "description": "Associates `members`, or principals, with a `role`.", "id": "Binding", @@ -1274,7 +1322,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" @@ -1365,6 +1413,21 @@ }, "type": "object" }, + "ImportAptArtifactsErrorInfo": { + "description": "Error information explaining why a package was not imported.", + "id": "ImportAptArtifactsErrorInfo", + "properties": { + "error": { + "$ref": "Status", + "description": "The detailed error status." + }, + "gcsSource": { + "$ref": "ImportAptArtifactsGcsSource", + "description": "Google Cloud Storage location requested." + } + }, + "type": "object" + }, "ImportAptArtifactsGcsSource": { "description": "Google Cloud Storage location where the artifacts currently reside.", "id": "ImportAptArtifactsGcsSource", @@ -1383,6 +1446,12 @@ }, "type": "object" }, + "ImportAptArtifactsMetadata": { + "description": "The operation metadata for importing artifacts.", + "id": "ImportAptArtifactsMetadata", + "properties": {}, + "type": "object" + }, "ImportAptArtifactsRequest": { "description": "The request to import new apt artifacts.", "id": "ImportAptArtifactsRequest", @@ -1394,6 +1463,42 @@ }, "type": "object" }, + "ImportAptArtifactsResponse": { + "description": "The response message from importing APT artifacts.", + "id": "ImportAptArtifactsResponse", + "properties": { + "aptArtifacts": { + "description": "The Apt artifacts imported.", + "items": { + "$ref": "AptArtifact" + }, + "type": "array" + }, + "errors": { + "description": "Detailed error info for packages that were not imported.", + "items": { + "$ref": "ImportAptArtifactsErrorInfo" + }, + "type": "array" + } + }, + "type": "object" + }, + "ImportYumArtifactsErrorInfo": { + "description": "Error information explaining why a package was not imported.", + "id": "ImportYumArtifactsErrorInfo", + "properties": { + "error": { + "$ref": "Status", + "description": "The detailed error status." + }, + "gcsSource": { + "$ref": "ImportYumArtifactsGcsSource", + "description": "Google Cloud Storage location requested." + } + }, + "type": "object" + }, "ImportYumArtifactsGcsSource": { "description": "Google Cloud Storage location where the artifacts currently reside.", "id": "ImportYumArtifactsGcsSource", @@ -1412,6 +1517,12 @@ }, "type": "object" }, + "ImportYumArtifactsMetadata": { + "description": "The operation metadata for importing artifacts.", + "id": "ImportYumArtifactsMetadata", + "properties": {}, + "type": "object" + }, "ImportYumArtifactsRequest": { "description": "The request to import new yum artifacts.", "id": "ImportYumArtifactsRequest", @@ -1423,6 +1534,27 @@ }, "type": "object" }, + "ImportYumArtifactsResponse": { + "description": "The response message from importing YUM artifacts.", + "id": "ImportYumArtifactsResponse", + "properties": { + "errors": { + "description": "Detailed error info for packages that were not imported.", + "items": { + "$ref": "ImportYumArtifactsErrorInfo" + }, + "type": "array" + }, + "yumArtifacts": { + "description": "The yum artifacts imported.", + "items": { + "$ref": "YumArtifact" + }, + "type": "array" + } + }, + "type": "object" + }, "ListDockerImagesResponse": { "description": "The response from listing docker images.", "id": "ListDockerImagesResponse", @@ -1643,6 +1775,12 @@ }, "type": "object" }, + "OperationMetadata": { + "description": "Metadata type for longrunning-operations, currently empty.", + "id": "OperationMetadata", + "properties": {}, + "type": "object" + }, "Package": { "description": "Packages are named collections of versions.", "id": "Package", @@ -1773,6 +1911,12 @@ "description": "The name of the repository, for example: \"projects/p1/locations/us-central1/repositories/repo1\".", "type": "string" }, + "sizeBytes": { + "description": "Output only. The size, in bytes, of all artifact storage in this repository. Repositories that are generally available or in public preview use this to calculate storage costs.", + "format": "int64", + "readOnly": true, + "type": "string" + }, "updateTime": { "description": "The time when the repository was last updated.", "format": "google-datetime", @@ -1879,6 +2023,20 @@ "properties": {}, "type": "object" }, + "UploadAptArtifactResponse": { + "description": "The response of the completed artifact upload operation. This response is contained in the Operation and available to users.", + "id": "UploadAptArtifactResponse", + "properties": { + "aptArtifacts": { + "description": "The Apt artifacts updated.", + "items": { + "$ref": "AptArtifact" + }, + "type": "array" + } + }, + "type": "object" + }, "UploadYumArtifactMediaResponse": { "description": "The response to upload an artifact.", "id": "UploadYumArtifactMediaResponse", @@ -1896,6 +2054,20 @@ "properties": {}, "type": "object" }, + "UploadYumArtifactResponse": { + "description": "The response of the completed artifact upload operation. This response is contained in the Operation and available to users.", + "id": "UploadYumArtifactResponse", + "properties": { + "yumArtifacts": { + "description": "The Apt artifacts updated.", + "items": { + "$ref": "YumArtifact" + }, + "type": "array" + } + }, + "type": "object" + }, "Version": { "description": "The body of a version resource. A version resource represents a collection of components, such as files and other data. This may correspond to a version in many package management schemes.", "id": "Version", @@ -1936,6 +2108,43 @@ } }, "type": "object" + }, + "YumArtifact": { + "description": "A detailed representation of a Yum artifact.", + "id": "YumArtifact", + "properties": { + "architecture": { + "description": "Output only. Operating system architecture of the artifact.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "Output only. The Artifact Registry resource name of the artifact.", + "readOnly": true, + "type": "string" + }, + "packageName": { + "description": "Output only. The yum package name of the artifact.", + "readOnly": true, + "type": "string" + }, + "packageType": { + "description": "Output only. An artifact is a binary or source package.", + "enum": [ + "PACKAGE_TYPE_UNSPECIFIED", + "BINARY", + "SOURCE" + ], + "enumDescriptions": [ + "Package type is not specified.", + "Binary package (.rpm).", + "Source package (.srpm)." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" } }, "servicePath": "", diff --git a/artifactregistry/v1/artifactregistry-gen.go b/artifactregistry/v1/artifactregistry-gen.go index e6559e1027b..677bb6e71f4 100644 --- a/artifactregistry/v1/artifactregistry-gen.go +++ b/artifactregistry/v1/artifactregistry-gen.go @@ -275,6 +275,59 @@ type ProjectsLocationsRepositoriesYumArtifactsService struct { s *Service } +// AptArtifact: A detailed representation of an Apt artifact. +// Information in the record is derived from the archive's control file. +// See https://www.debian.org/doc/debian-policy/ch-controlfields.html +type AptArtifact struct { + // Architecture: Output only. Operating system architecture of the + // artifact. + Architecture string `json:"architecture,omitempty"` + + // Component: Output only. Repository component of the artifact. + Component string `json:"component,omitempty"` + + // ControlFile: Output only. Contents of the artifact's control metadata + // file. + ControlFile string `json:"controlFile,omitempty"` + + // Name: Output only. The Artifact Registry resource name of the + // artifact. + Name string `json:"name,omitempty"` + + // PackageName: Output only. The Apt package name of the artifact. + PackageName string `json:"packageName,omitempty"` + + // PackageType: Output only. An artifact is a binary or source package. + // + // Possible values: + // "PACKAGE_TYPE_UNSPECIFIED" - Package type is not specified. + // "BINARY" - Binary package. + // "SOURCE" - Source package. + PackageType string `json:"packageType,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Architecture") 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. "Architecture") 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 *AptArtifact) MarshalJSON() ([]byte, error) { + type NoMethod AptArtifact + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Binding: Associates `members`, or principals, with a `role`. type Binding struct { // Condition: The condition that is associated with this binding. If the @@ -422,8 +475,7 @@ func (s *DockerImage) 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. @@ -577,6 +629,38 @@ func (s *Hash) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ImportAptArtifactsErrorInfo: Error information explaining why a +// package was not imported. +type ImportAptArtifactsErrorInfo struct { + // Error: The detailed error status. + Error *Status `json:"error,omitempty"` + + // GcsSource: Google Cloud Storage location requested. + GcsSource *ImportAptArtifactsGcsSource `json:"gcsSource,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Error") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. 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. "Error") 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 *ImportAptArtifactsErrorInfo) MarshalJSON() ([]byte, error) { + type NoMethod ImportAptArtifactsErrorInfo + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ImportAptArtifactsGcsSource: Google Cloud Storage location where the // artifacts currently reside. type ImportAptArtifactsGcsSource struct { @@ -610,6 +694,11 @@ func (s *ImportAptArtifactsGcsSource) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ImportAptArtifactsMetadata: The operation metadata for importing +// artifacts. +type ImportAptArtifactsMetadata struct { +} + // ImportAptArtifactsRequest: The request to import new apt artifacts. type ImportAptArtifactsRequest struct { // GcsSource: Google Cloud Storage location where input content is @@ -639,6 +728,70 @@ func (s *ImportAptArtifactsRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ImportAptArtifactsResponse: The response message from importing APT +// artifacts. +type ImportAptArtifactsResponse struct { + // AptArtifacts: The Apt artifacts imported. + AptArtifacts []*AptArtifact `json:"aptArtifacts,omitempty"` + + // Errors: Detailed error info for packages that were not imported. + Errors []*ImportAptArtifactsErrorInfo `json:"errors,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AptArtifacts") 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. "AptArtifacts") 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 *ImportAptArtifactsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ImportAptArtifactsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ImportYumArtifactsErrorInfo: Error information explaining why a +// package was not imported. +type ImportYumArtifactsErrorInfo struct { + // Error: The detailed error status. + Error *Status `json:"error,omitempty"` + + // GcsSource: Google Cloud Storage location requested. + GcsSource *ImportYumArtifactsGcsSource `json:"gcsSource,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Error") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. 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. "Error") 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 *ImportYumArtifactsErrorInfo) MarshalJSON() ([]byte, error) { + type NoMethod ImportYumArtifactsErrorInfo + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ImportYumArtifactsGcsSource: Google Cloud Storage location where the // artifacts currently reside. type ImportYumArtifactsGcsSource struct { @@ -672,6 +825,11 @@ func (s *ImportYumArtifactsGcsSource) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ImportYumArtifactsMetadata: The operation metadata for importing +// artifacts. +type ImportYumArtifactsMetadata struct { +} + // ImportYumArtifactsRequest: The request to import new yum artifacts. type ImportYumArtifactsRequest struct { // GcsSource: Google Cloud Storage location where input content is @@ -701,6 +859,38 @@ func (s *ImportYumArtifactsRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ImportYumArtifactsResponse: The response message from importing YUM +// artifacts. +type ImportYumArtifactsResponse struct { + // Errors: Detailed error info for packages that were not imported. + Errors []*ImportYumArtifactsErrorInfo `json:"errors,omitempty"` + + // YumArtifacts: The yum artifacts imported. + YumArtifacts []*YumArtifact `json:"yumArtifacts,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Errors") 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. "Errors") 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 *ImportYumArtifactsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ImportYumArtifactsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ListDockerImagesResponse: The response from listing docker images. type ListDockerImagesResponse struct { // DockerImages: The docker images returned. @@ -1111,6 +1301,11 @@ func (s *Operation) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// OperationMetadata: Metadata type for longrunning-operations, +// currently empty. +type OperationMetadata struct { +} + // Package: Packages are named collections of versions. type Package struct { // CreateTime: The time when the package was created. @@ -1354,6 +1549,11 @@ type Repository struct { // "projects/p1/locations/us-central1/repositories/repo1". Name string `json:"name,omitempty"` + // SizeBytes: Output only. The size, in bytes, of all artifact storage + // in this repository. Repositories that are generally available or in + // public preview use this to calculate storage costs. + SizeBytes int64 `json:"sizeBytes,omitempty,string"` + // UpdateTime: The time when the repository was last updated. UpdateTime string `json:"updateTime,omitempty"` @@ -1604,6 +1804,36 @@ func (s *UploadAptArtifactMediaResponse) MarshalJSON() ([]byte, error) { type UploadAptArtifactRequest struct { } +// UploadAptArtifactResponse: The response of the completed artifact +// upload operation. This response is contained in the Operation and +// available to users. +type UploadAptArtifactResponse struct { + // AptArtifacts: The Apt artifacts updated. + AptArtifacts []*AptArtifact `json:"aptArtifacts,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AptArtifacts") 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. "AptArtifacts") 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 *UploadAptArtifactResponse) MarshalJSON() ([]byte, error) { + type NoMethod UploadAptArtifactResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // UploadYumArtifactMediaResponse: The response to upload an artifact. type UploadYumArtifactMediaResponse struct { // Operation: Operation to be returned to the user. @@ -1640,6 +1870,36 @@ func (s *UploadYumArtifactMediaResponse) MarshalJSON() ([]byte, error) { type UploadYumArtifactRequest struct { } +// UploadYumArtifactResponse: The response of the completed artifact +// upload operation. This response is contained in the Operation and +// available to users. +type UploadYumArtifactResponse struct { + // YumArtifacts: The Apt artifacts updated. + YumArtifacts []*YumArtifact `json:"yumArtifacts,omitempty"` + + // ForceSendFields is a list of field names (e.g. "YumArtifacts") 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. "YumArtifacts") 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 *UploadYumArtifactResponse) MarshalJSON() ([]byte, error) { + type NoMethod UploadYumArtifactResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Version: The body of a version resource. A version resource // represents a collection of components, such as files and other data. // This may correspond to a version in many package management schemes. @@ -1697,6 +1957,50 @@ func (s *Version) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// YumArtifact: A detailed representation of a Yum artifact. +type YumArtifact struct { + // Architecture: Output only. Operating system architecture of the + // artifact. + Architecture string `json:"architecture,omitempty"` + + // Name: Output only. The Artifact Registry resource name of the + // artifact. + Name string `json:"name,omitempty"` + + // PackageName: Output only. The yum package name of the artifact. + PackageName string `json:"packageName,omitempty"` + + // PackageType: Output only. An artifact is a binary or source package. + // + // Possible values: + // "PACKAGE_TYPE_UNSPECIFIED" - Package type is not specified. + // "BINARY" - Binary package (.rpm). + // "SOURCE" - Source package (.srpm). + PackageType string `json:"packageType,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Architecture") 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. "Architecture") 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 *YumArtifact) MarshalJSON() ([]byte, error) { + type NoMethod YumArtifact + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // method id "artifactregistry.projects.getProjectSettings": type ProjectsGetProjectSettingsCall struct { diff --git a/artifactregistry/v1beta1/artifactregistry-api.json b/artifactregistry/v1beta1/artifactregistry-api.json index 0797586ba1b..9fa80bc1686 100644 --- a/artifactregistry/v1beta1/artifactregistry-api.json +++ b/artifactregistry/v1beta1/artifactregistry-api.json @@ -929,7 +929,7 @@ } } }, - "revision": "20220307", + "revision": "20220328", "rootUrl": "https://artifactregistry.googleapis.com/", "schemas": { "Binding": { @@ -955,7 +955,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" @@ -1322,6 +1322,12 @@ "description": "The name of the repository, for example: \"projects/p1/locations/us-central1/repositories/repo1\".", "type": "string" }, + "sizeBytes": { + "description": "Output only. The size, in bytes, of all artifact storage in this repository. Repositories that are generally available or in public preview use this to calculate storage costs.", + "format": "int64", + "readOnly": true, + "type": "string" + }, "updateTime": { "description": "The time when the repository was last updated.", "format": "google-datetime", diff --git a/artifactregistry/v1beta1/artifactregistry-gen.go b/artifactregistry/v1beta1/artifactregistry-gen.go index e37fe3d36dd..748157e6a57 100644 --- a/artifactregistry/v1beta1/artifactregistry-gen.go +++ b/artifactregistry/v1beta1/artifactregistry-gen.go @@ -316,8 +316,7 @@ func (s *Binding) 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. @@ -990,6 +989,11 @@ type Repository struct { // "projects/p1/locations/us-central1/repositories/repo1". Name string `json:"name,omitempty"` + // SizeBytes: Output only. The size, in bytes, of all artifact storage + // in this repository. Repositories that are generally available or in + // public preview use this to calculate storage costs. + SizeBytes int64 `json:"sizeBytes,omitempty,string"` + // UpdateTime: The time when the repository was last updated. UpdateTime string `json:"updateTime,omitempty"` diff --git a/artifactregistry/v1beta2/artifactregistry-api.json b/artifactregistry/v1beta2/artifactregistry-api.json index ee924cbc043..685de17f7a1 100644 --- a/artifactregistry/v1beta2/artifactregistry-api.json +++ b/artifactregistry/v1beta2/artifactregistry-api.json @@ -1135,7 +1135,7 @@ } } }, - "revision": "20220307", + "revision": "20220328", "rootUrl": "https://artifactregistry.googleapis.com/", "schemas": { "AptArtifact": { @@ -1209,7 +1209,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" @@ -1333,6 +1333,12 @@ }, "type": "object" }, + "ImportAptArtifactsMetadata": { + "description": "The operation metadata for importing artifacts.", + "id": "ImportAptArtifactsMetadata", + "properties": {}, + "type": "object" + }, "ImportAptArtifactsRequest": { "description": "The request to import new apt artifacts.", "id": "ImportAptArtifactsRequest", @@ -1398,6 +1404,12 @@ }, "type": "object" }, + "ImportYumArtifactsMetadata": { + "description": "The operation metadata for importing artifacts.", + "id": "ImportYumArtifactsMetadata", + "properties": {}, + "type": "object" + }, "ImportYumArtifactsRequest": { "description": "The request to import new yum artifacts.", "id": "ImportYumArtifactsRequest", @@ -1768,6 +1780,12 @@ "description": "The name of the repository, for example: \"projects/p1/locations/us-central1/repositories/repo1\".", "type": "string" }, + "sizeBytes": { + "description": "Output only. The size, in bytes, of all artifact storage in this repository. Repositories that are generally available or in public preview use this to calculate storage costs.", + "format": "int64", + "readOnly": true, + "type": "string" + }, "updateTime": { "description": "The time when the repository was last updated.", "format": "google-datetime", diff --git a/artifactregistry/v1beta2/artifactregistry-gen.go b/artifactregistry/v1beta2/artifactregistry-gen.go index 3372131cc73..9a2e1dc2fb1 100644 --- a/artifactregistry/v1beta2/artifactregistry-gen.go +++ b/artifactregistry/v1beta2/artifactregistry-gen.go @@ -393,8 +393,7 @@ func (s *Binding) 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. @@ -613,6 +612,11 @@ func (s *ImportAptArtifactsGcsSource) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ImportAptArtifactsMetadata: The operation metadata for importing +// artifacts. +type ImportAptArtifactsMetadata struct { +} + // ImportAptArtifactsRequest: The request to import new apt artifacts. type ImportAptArtifactsRequest struct { // GcsSource: Google Cloud Storage location where input content is @@ -739,6 +743,11 @@ func (s *ImportYumArtifactsGcsSource) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ImportYumArtifactsMetadata: The operation metadata for importing +// artifacts. +type ImportYumArtifactsMetadata struct { +} + // ImportYumArtifactsRequest: The request to import new yum artifacts. type ImportYumArtifactsRequest struct { // GcsSource: Google Cloud Storage location where input content is @@ -1422,6 +1431,11 @@ type Repository struct { // "projects/p1/locations/us-central1/repositories/repo1". Name string `json:"name,omitempty"` + // SizeBytes: Output only. The size, in bytes, of all artifact storage + // in this repository. Repositories that are generally available or in + // public preview use this to calculate storage costs. + SizeBytes int64 `json:"sizeBytes,omitempty,string"` + // UpdateTime: The time when the repository was last updated. UpdateTime string `json:"updateTime,omitempty"` diff --git a/chat/v1/chat-api.json b/chat/v1/chat-api.json index e2bfdd47f51..b04dce5edad 100644 --- a/chat/v1/chat-api.json +++ b/chat/v1/chat-api.json @@ -120,7 +120,7 @@ "type": "string" }, "threadKey": { - "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves bots and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", + "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves Chat apps and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", "location": "query", "type": "string" } @@ -155,7 +155,7 @@ "type": "string" }, "threadKey": { - "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves bots and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", + "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves Chat apps and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", "location": "query", "type": "string" } @@ -194,7 +194,7 @@ "type": "string" }, "threadKey": { - "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves bots and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", + "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves Chat apps and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", "location": "query", "type": "string" } @@ -262,7 +262,7 @@ "type": "string" }, "threadKey": { - "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves bots and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", + "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves Chat apps and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", "location": "query", "type": "string" } @@ -297,7 +297,7 @@ "type": "string" }, "threadKey": { - "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves bots and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", + "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves Chat apps and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", "location": "query", "type": "string" } @@ -336,7 +336,7 @@ "type": "string" }, "threadKey": { - "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves bots and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", + "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves Chat apps and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", "location": "query", "type": "string" } @@ -356,7 +356,7 @@ "spaces": { "methods": { "get": { - "description": "Returns a space.", + "description": "Returns a space. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", "flatPath": "v1/spaces/{spacesId}", "httpMethod": "GET", "id": "chat.spaces.get", @@ -378,7 +378,7 @@ } }, "list": { - "description": "Lists spaces the caller is a member of.", + "description": "Lists spaces the caller is a member of. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", "flatPath": "v1/spaces", "httpMethod": "GET", "id": "chat.spaces.list", @@ -423,7 +423,7 @@ "type": "string" }, "threadKey": { - "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves bots and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", + "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves Chat apps and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", "location": "query", "type": "string" } @@ -441,7 +441,7 @@ "members": { "methods": { "get": { - "description": "Returns a membership.", + "description": "Returns a membership. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", "flatPath": "v1/spaces/{spacesId}/members/{membersId}", "httpMethod": "GET", "id": "chat.spaces.members.get", @@ -463,7 +463,7 @@ } }, "list": { - "description": "Lists human memberships in a space.", + "description": "Lists human memberships in a space. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", "flatPath": "v1/spaces/{spacesId}/members", "httpMethod": "GET", "id": "chat.spaces.members.list", @@ -500,7 +500,7 @@ "messages": { "methods": { "create": { - "description": "Creates a message.", + "description": "Creates a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", "flatPath": "v1/spaces/{spacesId}/messages", "httpMethod": "POST", "id": "chat.spaces.messages.create", @@ -521,7 +521,7 @@ "type": "string" }, "threadKey": { - "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves bots and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", + "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves Chat apps and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", "location": "query", "type": "string" } @@ -535,7 +535,7 @@ } }, "delete": { - "description": "Deletes a message.", + "description": "Deletes a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}", "httpMethod": "DELETE", "id": "chat.spaces.messages.delete", @@ -557,7 +557,7 @@ } }, "get": { - "description": "Returns a message.", + "description": "Returns a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}", "httpMethod": "GET", "id": "chat.spaces.messages.get", @@ -579,7 +579,7 @@ } }, "update": { - "description": "Updates a message.", + "description": "Updates a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}", "httpMethod": "PUT", "id": "chat.spaces.messages.update", @@ -614,7 +614,7 @@ "attachments": { "methods": { "get": { - "description": "Gets the metadata of a message attachment. The attachment data is fetched using the media API.", + "description": "Gets the metadata of a message attachment. The attachment data is fetched using the media API. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}/attachments/{attachmentsId}", "httpMethod": "GET", "id": "chat.spaces.messages.attachments.get", @@ -642,7 +642,7 @@ } } }, - "revision": "20220319", + "revision": "20220326", "rootUrl": "https://chat.googleapis.com/", "schemas": { "ActionParameter": { @@ -661,15 +661,15 @@ "type": "object" }, "ActionResponse": { - "description": "Parameters that a bot can use to configure how it's response is posted.", + "description": "Parameters that a Chat app can use to configure how it's response is posted.", "id": "ActionResponse", "properties": { "dialogAction": { "$ref": "DialogAction", - "description": "A response to an event related to a [dialog](https://developers.google.com/chat/how-tos/bot-dialogs). Must be accompanied by `ResponseType.Dialog`." + "description": "A response to an event related to a [dialog](https://developers.google.com/chat/how-tos/dialogs). Must be accompanied by `ResponseType.Dialog`." }, "type": { - "description": "The type of bot response.", + "description": "The type of Chat app response.", "enum": [ "TYPE_UNSPECIFIED", "NEW_MESSAGE", @@ -681,10 +681,10 @@ "enumDescriptions": [ "Default type; will be handled as NEW_MESSAGE.", "Post as a new message in the topic.", - "Update the bot's message. This is only permitted on a CARD_CLICKED event where the message sender type is BOT.", + "Update the Chat app's message. This is only permitted on a CARD_CLICKED event where the message sender type is BOT.", "Update the cards on a user's message. This is only permitted as a response to a MESSAGE event with a matched url, or a CARD_CLICKED event where the message sender type is HUMAN. Text will be ignored.", "Privately ask the user for additional auth or config.", - "Presents a [dialog](https://developers.google.com/chat/how-tos/bot-dialogs)." + "Presents a [dialog](https://developers.google.com/chat/how-tos/dialogs)." ], "type": "string" }, @@ -804,7 +804,7 @@ "type": "string" }, "downloadUri": { - "description": "Output only. The download URL which should be used to allow a human user to download the attachment. Bots should not use this URL to download attachment content.", + "description": "Output only. The download URL which should be used to allow a human user to download the attachment. Chat apps should not use this URL to download attachment content.", "type": "string" }, "driveDataRef": { @@ -830,7 +830,7 @@ "type": "string" }, "thumbnailUri": { - "description": "Output only. The thumbnail URL which should be used to preview the attachment to a human user. Bots should not use this URL to download attachment content.", + "description": "Output only. The thumbnail URL which should be used to preview the attachment to a human user. Chat apps should not use this URL to download attachment content.", "type": "string" } }, @@ -966,14 +966,14 @@ "type": "object" }, "CommonEventObject": { - "description": "Represents information about the user's client, such as locale, host app, and platform. For Chat apps, `CommonEventObject` includes data submitted by users interacting with cards, like data entered in [dialogs](https://developers.google.com/chat/how-tos/bot-dialogs).", + "description": "Represents information about the user's client, such as locale, host app, and platform. For Chat apps, `CommonEventObject` includes data submitted by users interacting with cards, like data entered in [dialogs](https://developers.google.com/chat/how-tos/dialogs).", "id": "CommonEventObject", "properties": { "formInputs": { "additionalProperties": { "$ref": "Inputs" }, - "description": "A map containing the current values of the widgets in a card. The map keys are the string IDs assigned to each widget, and the values represent inputs to the widget. Depending on the input data type, a different object represents each input: For single-value widgets, `StringInput`. For multi-value widgets, an array of `StringInput` objects. For a date-time picker, a `DateTimeInput`. For a date-only picker, a `DateInput`. For a time-only picker, a `TimeInput`. Corresponds with the data entered by a user on a card in a [dialog](https://developers.google.com/chat/how-tos/bot-dialogs).", + "description": "A map containing the current values of the widgets in a card. The map keys are the string IDs assigned to each widget, and the values represent inputs to the widget. Depending on the input data type, a different object represents each input: For single-value widgets, `StringInput`. For multi-value widgets, an array of `StringInput` objects. For a date-time picker, a `DateTimeInput`. For a date-only picker, a `DateInput`. For a time-only picker, a `TimeInput`. Corresponds with the data entered by a user on a card in a [dialog](https://developers.google.com/chat/how-tos/dialogs).", "type": "object" }, "hostApp": { @@ -1084,14 +1084,14 @@ }, "common": { "$ref": "CommonEventObject", - "description": "Represents information about the user's client, such as locale, host app, and platform. For Chat apps, `CommonEventObject` includes information submitted by users interacting with [dialogs](https://developers.google.com/chat/how-tos/bot-dialogs), like data entered on a card." + "description": "Represents information about the user's client, such as locale, host app, and platform. For Chat apps, `CommonEventObject` includes information submitted by users interacting with [dialogs](https://developers.google.com/chat/how-tos/dialogs), like data entered on a card." }, "configCompleteRedirectUrl": { - "description": "The URL the bot should redirect the user to after they have completed an authorization or configuration flow outside of Google Chat. See the [Authorizing access to 3p services guide](/chat/how-tos/auth-3p) for more information.", + "description": "The URL the Chat app should redirect the user to after they have completed an authorization or configuration flow outside of Google Chat. See the [Authorizing access to 3p services guide](/chat/how-tos/auth-3p) for more information.", "type": "string" }, "dialogEventType": { - "description": "The type of [dialog](https://developers.google.com/chat/how-tos/bot-dialogs) event received.", + "description": "The type of [dialog](https://developers.google.com/chat/how-tos/dialogs) event received.", "enum": [ "TYPE_UNSPECIFIED", "REQUEST_DIALOG", @@ -1100,9 +1100,9 @@ ], "enumDescriptions": [ "This could be used when the corresponding event is not dialog related. For example an @mention.", - "Any user action that opens a [dialog](https://developers.google.com/chat/how-tos/bot-dialogs).", - "A card click event from a [dialog](https://developers.google.com/chat/how-tos/bot-dialogs).", - "The [dialog](https://developers.google.com/chat/how-tos/bot-dialogs) was cancelled." + "Any user action that opens a [dialog](https://developers.google.com/chat/how-tos/dialogs).", + "A card click event from a [dialog](https://developers.google.com/chat/how-tos/dialogs).", + "The [dialog](https://developers.google.com/chat/how-tos/dialogs) was cancelled." ], "type": "string" }, @@ -1112,7 +1112,7 @@ "type": "string" }, "isDialogEvent": { - "description": "True when the event is related to [dialogs](https://developers.google.com/chat/how-tos/bot-dialogs).", + "description": "True when the event is related to [dialogs](https://developers.google.com/chat/how-tos/dialogs).", "type": "boolean" }, "message": { @@ -1124,11 +1124,11 @@ "description": "The space in which the event occurred." }, "threadKey": { - "description": "The bot-defined key for the thread related to the event. See the thread_key field of the `spaces.message.create` request for more information.", + "description": "The Chat app-defined key for the thread related to the event. See the thread_key field of the `spaces.message.create` request for more information.", "type": "string" }, "token": { - "description": "A secret value that bots can use to verify if a request is from Google. The token is randomly generated by Google, remains static, and can be obtained from the Google Chat API configuration page in the Cloud Console. Developers can revoke/regenerate it if needed from the same page.", + "description": "A secret value that Chat apps can use to verify if a request is from Google. The token is randomly generated by Google, remains static, and can be obtained from the Google Chat API configuration page in the Cloud Console. Developers can revoke/regenerate it if needed from the same page.", "type": "string" }, "type": { @@ -1143,9 +1143,9 @@ "enumDescriptions": [ "Default value for the enum. DO NOT USE.", "A message was sent in a space.", - "The bot was added to a space.", - "The bot was removed from a space.", - "The bot's interactive card was clicked." + "The Chat app was added to a space.", + "The Chat app was removed from a space.", + "The Chat app's interactive card was clicked." ], "type": "string" }, @@ -1168,16 +1168,16 @@ "type": "object" }, "DialogAction": { - "description": "Contains a [dialog](https://developers.google.com/chat/how-tos/bot-dialogs) and request status code.", + "description": "Contains a [dialog](https://developers.google.com/chat/how-tos/dialogs) and request status code.", "id": "DialogAction", "properties": { "actionStatus": { "$ref": "ActionStatus", - "description": "Status for a request to either invoke or submit a [dialog](https://developers.google.com/chat/how-tos/bot-dialogs). Displays a status and message to users, if necessary. For example, in case of an error or success." + "description": "Status for a request to either invoke or submit a [dialog](https://developers.google.com/chat/how-tos/dialogs). Displays a status and message to users, if necessary. For example, in case of an error or success." }, "dialog": { "$ref": "Dialog", - "description": "[Dialog](https://developers.google.com/chat/how-tos/bot-dialogs) for the request." + "description": "[Dialog](https://developers.google.com/chat/how-tos/dialogs) for the request." } }, "type": "object" @@ -1223,7 +1223,7 @@ "id": "FormAction", "properties": { "actionMethodName": { - "description": "The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.", + "description": "The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the Chat app as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.", "type": "string" }, "parameters": { @@ -2355,7 +2355,7 @@ "type": "object" }, "MatchedUrl": { - "description": "A matched url in a Chat message. Chat bots can unfurl matched URLs. For more information, refer to [Unfurl links](/chat/how-tos/link-unfurling).", + "description": "A matched url in a Chat message. Chat apps can unfurl matched URLs. For more information, refer to [Unfurl links](/chat/how-tos/link-unfurling).", "id": "MatchedUrl", "properties": { "url": { @@ -2419,7 +2419,7 @@ "properties": { "actionResponse": { "$ref": "ActionResponse", - "description": "Input only. Parameters that a bot can use to configure how its response is posted." + "description": "Input only. Parameters that a Chat app can use to configure how its response is posted." }, "annotations": { "description": "Output only. Annotations associated with the text in this message.", @@ -2429,7 +2429,7 @@ "type": "array" }, "argumentText": { - "description": "Plain-text body of the message with all bot mentions stripped out.", + "description": "Plain-text body of the message with all Chat app mentions stripped out.", "type": "string" }, "attachment": { @@ -2470,10 +2470,6 @@ "description": "Resource name in the form `spaces/*/messages/*`. Example: `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`", "type": "string" }, - "previewText": { - "description": "Text for generating preview chips. This text will not be displayed to the user, but any links to images, web pages, videos, etc. included here will generate preview chips.", - "type": "string" - }, "sender": { "$ref": "User", "description": "The user who created the message." @@ -2487,7 +2483,7 @@ "description": "The space the message belongs to." }, "text": { - "description": "Plain-text body of the message.", + "description": "Plain-text body of the message. The first link to an image, video, web page, or other preview-able item generates a preview chip.", "type": "string" }, "thread": { @@ -2559,7 +2555,7 @@ "properties": { "bot": { "$ref": "User", - "description": "The bot whose command was invoked." + "description": "The Chat app whose command was invoked." }, "commandId": { "description": "The command id of the invoked slash command.", @@ -2583,7 +2579,7 @@ ], "enumDescriptions": [ "Default value for the enum. DO NOT USE.", - "Add bot to space.", + "Add Chat app to space.", "Invoke slash command in space." ], "type": "string" @@ -2592,7 +2588,7 @@ "type": "object" }, "Space": { - "description": "A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat bot.", + "description": "A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat app.", "id": "Space", "properties": { "displayName": { @@ -2604,7 +2600,7 @@ "type": "string" }, "singleUserBotDm": { - "description": "Output only. Whether the space is a DM between a bot and a single human.", + "description": "Output only. Whether the space is a DM between a Chat app and a single human.", "readOnly": true, "type": "boolean" }, @@ -2623,7 +2619,7 @@ "enumDescriptions": [ "", "Conversations between two or more humans.", - "1:1 Direct Message between a human and a Chat bot, where all messages are flat. Note that this does not include direct messages between two humans." + "1:1 Direct Message between a human and a Chat app, where all messages are flat. Note that this does not include direct messages between two humans." ], "type": "string" } @@ -2770,7 +2766,7 @@ "enumDescriptions": [ "Default value for the enum. DO NOT USE.", "Human user.", - "Bot user." + "Chat app user." ], "type": "string" } diff --git a/chat/v1/chat-gen.go b/chat/v1/chat-gen.go index 90aa92d352d..b648da7639e 100644 --- a/chat/v1/chat-gen.go +++ b/chat/v1/chat-gen.go @@ -265,21 +265,22 @@ func (s *ActionParameter) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ActionResponse: Parameters that a bot can use to configure how it's -// response is posted. +// ActionResponse: Parameters that a Chat app can use to configure how +// it's response is posted. type ActionResponse struct { // DialogAction: A response to an event related to a dialog - // (https://developers.google.com/chat/how-tos/bot-dialogs). Must be + // (https://developers.google.com/chat/how-tos/dialogs). Must be // accompanied by `ResponseType.Dialog`. DialogAction *DialogAction `json:"dialogAction,omitempty"` - // Type: The type of bot response. + // Type: The type of Chat app response. // // Possible values: // "TYPE_UNSPECIFIED" - Default type; will be handled as NEW_MESSAGE. // "NEW_MESSAGE" - Post as a new message in the topic. - // "UPDATE_MESSAGE" - Update the bot's message. This is only permitted - // on a CARD_CLICKED event where the message sender type is BOT. + // "UPDATE_MESSAGE" - Update the Chat app's message. This is only + // permitted on a CARD_CLICKED event where the message sender type is + // BOT. // "UPDATE_USER_MESSAGE_CARDS" - Update the cards on a user's message. // This is only permitted as a response to a MESSAGE event with a // matched url, or a CARD_CLICKED event where the message sender type is @@ -287,7 +288,7 @@ type ActionResponse struct { // "REQUEST_CONFIG" - Privately ask the user for additional auth or // config. // "DIALOG" - Presents a - // [dialog](https://developers.google.com/chat/how-tos/bot-dialogs). + // [dialog](https://developers.google.com/chat/how-tos/dialogs). Type string `json:"type,omitempty"` // Url: URL for users to auth or config. (Only for REQUEST_CONFIG @@ -507,8 +508,8 @@ type Attachment struct { ContentType string `json:"contentType,omitempty"` // DownloadUri: Output only. The download URL which should be used to - // allow a human user to download the attachment. Bots should not use - // this URL to download attachment content. + // allow a human user to download the attachment. Chat apps should not + // use this URL to download attachment content. DownloadUri string `json:"downloadUri,omitempty"` // DriveDataRef: A reference to the drive attachment. This is used with @@ -528,8 +529,8 @@ type Attachment struct { Source string `json:"source,omitempty"` // ThumbnailUri: Output only. The thumbnail URL which should be used to - // preview the attachment to a human user. Bots should not use this URL - // to download attachment content. + // preview the attachment to a human user. Chat apps should not use this + // URL to download attachment content. ThumbnailUri string `json:"thumbnailUri,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -860,7 +861,7 @@ func (s *Color) UnmarshalJSON(data []byte) error { // such as locale, host app, and platform. For Chat apps, // `CommonEventObject` includes data submitted by users interacting with // cards, like data entered in dialogs -// (https://developers.google.com/chat/how-tos/bot-dialogs). +// (https://developers.google.com/chat/how-tos/dialogs). type CommonEventObject struct { // FormInputs: A map containing the current values of the widgets in a // card. The map keys are the string IDs assigned to each widget, and @@ -870,7 +871,7 @@ type CommonEventObject struct { // `StringInput` objects. For a date-time picker, a `DateTimeInput`. For // a date-only picker, a `DateInput`. For a time-only picker, a // `TimeInput`. Corresponds with the data entered by a user on a card in - // a dialog (https://developers.google.com/chat/how-tos/bot-dialogs). + // a dialog (https://developers.google.com/chat/how-tos/dialogs). FormInputs map[string]Inputs `json:"formInputs,omitempty"` // HostApp: The hostApp enum which indicates the app the add-on is @@ -1015,29 +1016,28 @@ type DeprecatedEvent struct { // Common: Represents information about the user's client, such as // locale, host app, and platform. For Chat apps, `CommonEventObject` // includes information submitted by users interacting with dialogs - // (https://developers.google.com/chat/how-tos/bot-dialogs), like data + // (https://developers.google.com/chat/how-tos/dialogs), like data // entered on a card. Common *CommonEventObject `json:"common,omitempty"` - // ConfigCompleteRedirectUrl: The URL the bot should redirect the user - // to after they have completed an authorization or configuration flow - // outside of Google Chat. See the Authorizing access to 3p services - // guide (/chat/how-tos/auth-3p) for more information. + // ConfigCompleteRedirectUrl: The URL the Chat app should redirect the + // user to after they have completed an authorization or configuration + // flow outside of Google Chat. See the Authorizing access to 3p + // services guide (/chat/how-tos/auth-3p) for more information. ConfigCompleteRedirectUrl string `json:"configCompleteRedirectUrl,omitempty"` // DialogEventType: The type of dialog - // (https://developers.google.com/chat/how-tos/bot-dialogs) event - // received. + // (https://developers.google.com/chat/how-tos/dialogs) event received. // // Possible values: // "TYPE_UNSPECIFIED" - This could be used when the corresponding // event is not dialog related. For example an @mention. // "REQUEST_DIALOG" - Any user action that opens a - // [dialog](https://developers.google.com/chat/how-tos/bot-dialogs). + // [dialog](https://developers.google.com/chat/how-tos/dialogs). // "SUBMIT_DIALOG" - A card click event from a - // [dialog](https://developers.google.com/chat/how-tos/bot-dialogs). + // [dialog](https://developers.google.com/chat/how-tos/dialogs). // "CANCEL_DIALOG" - The - // [dialog](https://developers.google.com/chat/how-tos/bot-dialogs) was + // [dialog](https://developers.google.com/chat/how-tos/dialogs) was // cancelled. DialogEventType string `json:"dialogEventType,omitempty"` @@ -1045,7 +1045,7 @@ type DeprecatedEvent struct { EventTime string `json:"eventTime,omitempty"` // IsDialogEvent: True when the event is related to dialogs - // (https://developers.google.com/chat/how-tos/bot-dialogs). + // (https://developers.google.com/chat/how-tos/dialogs). IsDialogEvent bool `json:"isDialogEvent,omitempty"` // Message: The message that triggered the event, if applicable. @@ -1054,13 +1054,13 @@ type DeprecatedEvent struct { // Space: The space in which the event occurred. Space *Space `json:"space,omitempty"` - // ThreadKey: The bot-defined key for the thread related to the event. - // See the thread_key field of the `spaces.message.create` request for - // more information. + // ThreadKey: The Chat app-defined key for the thread related to the + // event. See the thread_key field of the `spaces.message.create` + // request for more information. ThreadKey string `json:"threadKey,omitempty"` - // Token: A secret value that bots can use to verify if a request is - // from Google. The token is randomly generated by Google, remains + // Token: A secret value that Chat apps can use to verify if a request + // is from Google. The token is randomly generated by Google, remains // static, and can be obtained from the Google Chat API configuration // page in the Cloud Console. Developers can revoke/regenerate it if // needed from the same page. @@ -1071,9 +1071,9 @@ type DeprecatedEvent struct { // Possible values: // "UNSPECIFIED" - Default value for the enum. DO NOT USE. // "MESSAGE" - A message was sent in a space. - // "ADDED_TO_SPACE" - The bot was added to a space. - // "REMOVED_FROM_SPACE" - The bot was removed from a space. - // "CARD_CLICKED" - The bot's interactive card was clicked. + // "ADDED_TO_SPACE" - The Chat app was added to a space. + // "REMOVED_FROM_SPACE" - The Chat app was removed from a space. + // "CARD_CLICKED" - The Chat app's interactive card was clicked. Type string `json:"type,omitempty"` // User: The user that triggered the event. @@ -1133,18 +1133,17 @@ func (s *Dialog) MarshalJSON() ([]byte, error) { } // DialogAction: Contains a dialog -// (https://developers.google.com/chat/how-tos/bot-dialogs) and request +// (https://developers.google.com/chat/how-tos/dialogs) and request // status code. type DialogAction struct { // ActionStatus: Status for a request to either invoke or submit a - // dialog (https://developers.google.com/chat/how-tos/bot-dialogs). - // Displays a status and message to users, if necessary. For example, in - // case of an error or success. + // dialog (https://developers.google.com/chat/how-tos/dialogs). Displays + // a status and message to users, if necessary. For example, in case of + // an error or success. ActionStatus *ActionStatus `json:"actionStatus,omitempty"` - // Dialog: Dialog - // (https://developers.google.com/chat/how-tos/bot-dialogs) for the - // request. + // Dialog: Dialog (https://developers.google.com/chat/how-tos/dialogs) + // for the request. Dialog *Dialog `json:"dialog,omitempty"` // ForceSendFields is a list of field names (e.g. "ActionStatus") to @@ -1253,9 +1252,9 @@ type Empty struct { type FormAction struct { // ActionMethodName: The method name is used to identify which part of // the form triggered the form submission. This information is echoed - // back to the bot as part of the card click event. The same method name - // can be used for several elements that trigger a common behavior if - // desired. + // back to the Chat app as part of the card click event. The same method + // name can be used for several elements that trigger a common behavior + // if desired. ActionMethodName string `json:"actionMethodName,omitempty"` // Parameters: List of action parameters. @@ -2945,7 +2944,7 @@ func (s *ListSpacesResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// MatchedUrl: A matched url in a Chat message. Chat bots can unfurl +// MatchedUrl: A matched url in a Chat message. Chat apps can unfurl // matched URLs. For more information, refer to Unfurl links // (/chat/how-tos/link-unfurling). type MatchedUrl struct { @@ -3062,7 +3061,7 @@ func (s *Membership) MarshalJSON() ([]byte, error) { // Message: A message in Google Chat. type Message struct { - // ActionResponse: Input only. Parameters that a bot can use to + // ActionResponse: Input only. Parameters that a Chat app can use to // configure how its response is posted. ActionResponse *ActionResponse `json:"actionResponse,omitempty"` @@ -3070,8 +3069,8 @@ type Message struct { // this message. Annotations []*Annotation `json:"annotations,omitempty"` - // ArgumentText: Plain-text body of the message with all bot mentions - // stripped out. + // ArgumentText: Plain-text body of the message with all Chat app + // mentions stripped out. ArgumentText string `json:"argumentText,omitempty"` // Attachment: User uploaded attachment. @@ -3106,11 +3105,6 @@ type Message struct { // `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB` Name string `json:"name,omitempty"` - // PreviewText: Text for generating preview chips. This text will not be - // displayed to the user, but any links to images, web pages, videos, - // etc. included here will generate preview chips. - PreviewText string `json:"previewText,omitempty"` - // Sender: The user who created the message. Sender *User `json:"sender,omitempty"` @@ -3120,7 +3114,8 @@ type Message struct { // Space: The space the message belongs to. Space *Space `json:"space,omitempty"` - // Text: Plain-text body of the message. + // Text: Plain-text body of the message. The first link to an image, + // video, web page, or other preview-able item generates a preview chip. Text string `json:"text,omitempty"` // Thread: The thread the message belongs to. @@ -3279,7 +3274,7 @@ func (s *SlashCommand) MarshalJSON() ([]byte, error) { // SlashCommandMetadata: Annotation metadata for slash commands (/). type SlashCommandMetadata struct { - // Bot: The bot whose command was invoked. + // Bot: The Chat app whose command was invoked. Bot *User `json:"bot,omitempty"` // CommandId: The command id of the invoked slash command. @@ -3295,7 +3290,7 @@ type SlashCommandMetadata struct { // // Possible values: // "TYPE_UNSPECIFIED" - Default value for the enum. DO NOT USE. - // "ADD" - Add bot to space. + // "ADD" - Add Chat app to space. // "INVOKE" - Invoke slash command in space. Type string `json:"type,omitempty"` @@ -3323,7 +3318,7 @@ func (s *SlashCommandMetadata) MarshalJSON() ([]byte, error) { } // Space: A space in Google Chat. Spaces are conversations between two -// or more users or 1:1 messages between a user and a Chat bot. +// or more users or 1:1 messages between a user and a Chat app. type Space struct { // DisplayName: The space's display name. For direct messages between // humans, this field might be empty. @@ -3333,8 +3328,8 @@ type Space struct { // Example: spaces/AAAAAAAAAAAA Name string `json:"name,omitempty"` - // SingleUserBotDm: Output only. Whether the space is a DM between a bot - // and a single human. + // SingleUserBotDm: Output only. Whether the space is a DM between a + // Chat app and a single human. SingleUserBotDm bool `json:"singleUserBotDm,omitempty"` // Threaded: Output only. Whether the messages are threaded in this @@ -3347,7 +3342,7 @@ type Space struct { // Possible values: // "TYPE_UNSPECIFIED" // "ROOM" - Conversations between two or more humans. - // "DM" - 1:1 Direct Message between a human and a Chat bot, where all + // "DM" - 1:1 Direct Message between a human and a Chat app, where all // messages are flat. Note that this does not include direct messages // between two humans. Type string `json:"type,omitempty"` @@ -3630,7 +3625,7 @@ type User struct { // Possible values: // "TYPE_UNSPECIFIED" - Default value for the enum. DO NOT USE. // "HUMAN" - Human user. - // "BOT" - Bot user. + // "BOT" - Chat app user. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "DisplayName") to @@ -3767,7 +3762,7 @@ func (c *DmsMessagesCall) RequestId(requestId string) *DmsMessagesCall { // single thread. If this is the first message with a given thread // identifier, a new thread is created. Subsequent messages with the // same thread identifier will be posted into the same thread. This -// relieves bots and webhooks from having to store the Google Chat +// relieves Chat apps and webhooks from having to store the Google Chat // thread ID of a thread (created earlier by them) to post further // updates to it. Has no effect if thread field, corresponding to an // existing thread, is set in message. @@ -3888,7 +3883,7 @@ func (c *DmsMessagesCall) Do(opts ...googleapi.CallOption) (*Message, error) { // "type": "string" // }, // "threadKey": { - // "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves bots and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", + // "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves Chat apps and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", // "location": "query", // "type": "string" // } @@ -3940,7 +3935,7 @@ func (c *DmsWebhooksCall) RequestId(requestId string) *DmsWebhooksCall { // single thread. If this is the first message with a given thread // identifier, a new thread is created. Subsequent messages with the // same thread identifier will be posted into the same thread. This -// relieves bots and webhooks from having to store the Google Chat +// relieves Chat apps and webhooks from having to store the Google Chat // thread ID of a thread (created earlier by them) to post further // updates to it. Has no effect if thread field, corresponding to an // existing thread, is set in message. @@ -4061,7 +4056,7 @@ func (c *DmsWebhooksCall) Do(opts ...googleapi.CallOption) (*Message, error) { // "type": "string" // }, // "threadKey": { - // "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves bots and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", + // "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves Chat apps and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", // "location": "query", // "type": "string" // } @@ -4113,7 +4108,7 @@ func (c *DmsConversationsMessagesCall) RequestId(requestId string) *DmsConversat // single thread. If this is the first message with a given thread // identifier, a new thread is created. Subsequent messages with the // same thread identifier will be posted into the same thread. This -// relieves bots and webhooks from having to store the Google Chat +// relieves Chat apps and webhooks from having to store the Google Chat // thread ID of a thread (created earlier by them) to post further // updates to it. Has no effect if thread field, corresponding to an // existing thread, is set in message. @@ -4234,7 +4229,7 @@ func (c *DmsConversationsMessagesCall) Do(opts ...googleapi.CallOption) (*Messag // "type": "string" // }, // "threadKey": { - // "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves bots and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", + // "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves Chat apps and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", // "location": "query", // "type": "string" // } @@ -4448,7 +4443,7 @@ func (c *RoomsMessagesCall) RequestId(requestId string) *RoomsMessagesCall { // single thread. If this is the first message with a given thread // identifier, a new thread is created. Subsequent messages with the // same thread identifier will be posted into the same thread. This -// relieves bots and webhooks from having to store the Google Chat +// relieves Chat apps and webhooks from having to store the Google Chat // thread ID of a thread (created earlier by them) to post further // updates to it. Has no effect if thread field, corresponding to an // existing thread, is set in message. @@ -4569,7 +4564,7 @@ func (c *RoomsMessagesCall) Do(opts ...googleapi.CallOption) (*Message, error) { // "type": "string" // }, // "threadKey": { - // "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves bots and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", + // "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves Chat apps and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", // "location": "query", // "type": "string" // } @@ -4621,7 +4616,7 @@ func (c *RoomsWebhooksCall) RequestId(requestId string) *RoomsWebhooksCall { // single thread. If this is the first message with a given thread // identifier, a new thread is created. Subsequent messages with the // same thread identifier will be posted into the same thread. This -// relieves bots and webhooks from having to store the Google Chat +// relieves Chat apps and webhooks from having to store the Google Chat // thread ID of a thread (created earlier by them) to post further // updates to it. Has no effect if thread field, corresponding to an // existing thread, is set in message. @@ -4742,7 +4737,7 @@ func (c *RoomsWebhooksCall) Do(opts ...googleapi.CallOption) (*Message, error) { // "type": "string" // }, // "threadKey": { - // "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves bots and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", + // "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves Chat apps and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", // "location": "query", // "type": "string" // } @@ -4794,7 +4789,7 @@ func (c *RoomsConversationsMessagesCall) RequestId(requestId string) *RoomsConve // single thread. If this is the first message with a given thread // identifier, a new thread is created. Subsequent messages with the // same thread identifier will be posted into the same thread. This -// relieves bots and webhooks from having to store the Google Chat +// relieves Chat apps and webhooks from having to store the Google Chat // thread ID of a thread (created earlier by them) to post further // updates to it. Has no effect if thread field, corresponding to an // existing thread, is set in message. @@ -4915,7 +4910,7 @@ func (c *RoomsConversationsMessagesCall) Do(opts ...googleapi.CallOption) (*Mess // "type": "string" // }, // "threadKey": { - // "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves bots and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", + // "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves Chat apps and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", // "location": "query", // "type": "string" // } @@ -4942,7 +4937,8 @@ type SpacesGetCall struct { header_ http.Header } -// Get: Returns a space. +// Get: Returns a space. Requires service account authentication +// (https://developers.google.com/chat/api/guides/auth/service-accounts). // // - name: Resource name of the space, in the form "spaces/*". Example: // spaces/AAAAAAAAAAAA. @@ -5051,7 +5047,7 @@ func (c *SpacesGetCall) Do(opts ...googleapi.CallOption) (*Space, error) { } return ret, nil // { - // "description": "Returns a space.", + // "description": "Returns a space. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", // "flatPath": "v1/spaces/{spacesId}", // "httpMethod": "GET", // "id": "chat.spaces.get", @@ -5085,7 +5081,9 @@ type SpacesListCall struct { header_ http.Header } -// List: Lists spaces the caller is a member of. +// List: Lists spaces the caller is a member of. Requires service +// account authentication +// (https://developers.google.com/chat/api/guides/auth/service-accounts). func (r *SpacesService) List() *SpacesListCall { c := &SpacesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c @@ -5202,7 +5200,7 @@ func (c *SpacesListCall) Do(opts ...googleapi.CallOption) (*ListSpacesResponse, } return ret, nil // { - // "description": "Lists spaces the caller is a member of.", + // "description": "Lists spaces the caller is a member of. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", // "flatPath": "v1/spaces", // "httpMethod": "GET", // "id": "chat.spaces.list", @@ -5285,7 +5283,7 @@ func (c *SpacesWebhooksCall) RequestId(requestId string) *SpacesWebhooksCall { // single thread. If this is the first message with a given thread // identifier, a new thread is created. Subsequent messages with the // same thread identifier will be posted into the same thread. This -// relieves bots and webhooks from having to store the Google Chat +// relieves Chat apps and webhooks from having to store the Google Chat // thread ID of a thread (created earlier by them) to post further // updates to it. Has no effect if thread field, corresponding to an // existing thread, is set in message. @@ -5406,7 +5404,7 @@ func (c *SpacesWebhooksCall) Do(opts ...googleapi.CallOption) (*Message, error) // "type": "string" // }, // "threadKey": { - // "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves bots and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", + // "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves Chat apps and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", // "location": "query", // "type": "string" // } @@ -5433,7 +5431,8 @@ type SpacesMembersGetCall struct { header_ http.Header } -// Get: Returns a membership. +// Get: Returns a membership. Requires service account authentication +// (https://developers.google.com/chat/api/guides/auth/service-accounts). // // - name: Resource name of the membership to be retrieved, in the form // "spaces/*/members/*". Example: @@ -5543,7 +5542,7 @@ func (c *SpacesMembersGetCall) Do(opts ...googleapi.CallOption) (*Membership, er } return ret, nil // { - // "description": "Returns a membership.", + // "description": "Returns a membership. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", // "flatPath": "v1/spaces/{spacesId}/members/{membersId}", // "httpMethod": "GET", // "id": "chat.spaces.members.get", @@ -5578,7 +5577,9 @@ type SpacesMembersListCall struct { header_ http.Header } -// List: Lists human memberships in a space. +// List: Lists human memberships in a space. Requires service account +// authentication +// (https://developers.google.com/chat/api/guides/auth/service-accounts). // // - parent: The resource name of the space for which membership list is // to be fetched, in the form "spaces/*". Example: spaces/AAAAAAAAAAAA. @@ -5702,7 +5703,7 @@ func (c *SpacesMembersListCall) Do(opts ...googleapi.CallOption) (*ListMembershi } return ret, nil // { - // "description": "Lists human memberships in a space.", + // "description": "Lists human memberships in a space. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", // "flatPath": "v1/spaces/{spacesId}/members", // "httpMethod": "GET", // "id": "chat.spaces.members.list", @@ -5769,7 +5770,8 @@ type SpacesMessagesCreateCall struct { header_ http.Header } -// Create: Creates a message. +// Create: Creates a message. Requires service account authentication +// (https://developers.google.com/chat/api/guides/auth/service-accounts). // // - parent: Space resource name, in the form "spaces/*". Example: // spaces/AAAAAAAAAAA. @@ -5793,7 +5795,7 @@ func (c *SpacesMessagesCreateCall) RequestId(requestId string) *SpacesMessagesCr // single thread. If this is the first message with a given thread // identifier, a new thread is created. Subsequent messages with the // same thread identifier will be posted into the same thread. This -// relieves bots and webhooks from having to store the Google Chat +// relieves Chat apps and webhooks from having to store the Google Chat // thread ID of a thread (created earlier by them) to post further // updates to it. Has no effect if thread field, corresponding to an // existing thread, is set in message. @@ -5893,7 +5895,7 @@ func (c *SpacesMessagesCreateCall) Do(opts ...googleapi.CallOption) (*Message, e } return ret, nil // { - // "description": "Creates a message.", + // "description": "Creates a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", // "flatPath": "v1/spaces/{spacesId}/messages", // "httpMethod": "POST", // "id": "chat.spaces.messages.create", @@ -5914,7 +5916,7 @@ func (c *SpacesMessagesCreateCall) Do(opts ...googleapi.CallOption) (*Message, e // "type": "string" // }, // "threadKey": { - // "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves bots and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", + // "description": "Optional. Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves Chat apps and webhooks from having to store the Google Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.", // "location": "query", // "type": "string" // } @@ -5940,7 +5942,8 @@ type SpacesMessagesDeleteCall struct { header_ http.Header } -// Delete: Deletes a message. +// Delete: Deletes a message. Requires service account authentication +// (https://developers.google.com/chat/api/guides/auth/service-accounts). // // - name: Resource name of the message to be deleted, in the form // "spaces/*/messages/*" Example: @@ -6037,7 +6040,7 @@ func (c *SpacesMessagesDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, err } return ret, nil // { - // "description": "Deletes a message.", + // "description": "Deletes a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", // "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}", // "httpMethod": "DELETE", // "id": "chat.spaces.messages.delete", @@ -6072,7 +6075,8 @@ type SpacesMessagesGetCall struct { header_ http.Header } -// Get: Returns a message. +// Get: Returns a message. Requires service account authentication +// (https://developers.google.com/chat/api/guides/auth/service-accounts). // // - name: Resource name of the message to be retrieved, in the form // "spaces/*/messages/*". Example: @@ -6182,7 +6186,7 @@ func (c *SpacesMessagesGetCall) Do(opts ...googleapi.CallOption) (*Message, erro } return ret, nil // { - // "description": "Returns a message.", + // "description": "Returns a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", // "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}", // "httpMethod": "GET", // "id": "chat.spaces.messages.get", @@ -6217,7 +6221,8 @@ type SpacesMessagesUpdateCall struct { header_ http.Header } -// Update: Updates a message. +// Update: Updates a message. Requires service account authentication +// (https://developers.google.com/chat/api/guides/auth/service-accounts). // // - name: Resource name in the form `spaces/*/messages/*`. Example: // `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. @@ -6327,7 +6332,7 @@ func (c *SpacesMessagesUpdateCall) Do(opts ...googleapi.CallOption) (*Message, e } return ret, nil // { - // "description": "Updates a message.", + // "description": "Updates a message. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", // "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}", // "httpMethod": "PUT", // "id": "chat.spaces.messages.update", @@ -6372,7 +6377,9 @@ type SpacesMessagesAttachmentsGetCall struct { } // Get: Gets the metadata of a message attachment. The attachment data -// is fetched using the media API. +// is fetched using the media API. Requires service account +// authentication +// (https://developers.google.com/chat/api/guides/auth/service-accounts). // // - name: Resource name of the attachment, in the form // "spaces/*/messages/*/attachments/*". @@ -6481,7 +6488,7 @@ func (c *SpacesMessagesAttachmentsGetCall) Do(opts ...googleapi.CallOption) (*At } return ret, nil // { - // "description": "Gets the metadata of a message attachment. The attachment data is fetched using the media API.", + // "description": "Gets the metadata of a message attachment. The attachment data is fetched using the media API. Requires [service account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).", // "flatPath": "v1/spaces/{spacesId}/messages/{messagesId}/attachments/{attachmentsId}", // "httpMethod": "GET", // "id": "chat.spaces.messages.attachments.get", diff --git a/cloudtasks/v2/cloudtasks-api.json b/cloudtasks/v2/cloudtasks-api.json index 451cd0d49ed..1e0517b64cd 100644 --- a/cloudtasks/v2/cloudtasks-api.json +++ b/cloudtasks/v2/cloudtasks-api.json @@ -685,7 +685,7 @@ } } }, - "revision": "20211130", + "revision": "20220321", "rootUrl": "https://cloudtasks.googleapis.com/", "schemas": { "AppEngineHttpRequest": { @@ -836,7 +836,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/cloudtasks/v2/cloudtasks-gen.go b/cloudtasks/v2/cloudtasks-gen.go index 1f838e6dc51..1f44e1201a6 100644 --- a/cloudtasks/v2/cloudtasks-gen.go +++ b/cloudtasks/v2/cloudtasks-gen.go @@ -587,8 +587,7 @@ func (s *CreateTaskRequest) 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. diff --git a/cloudtasks/v2beta2/cloudtasks-api.json b/cloudtasks/v2beta2/cloudtasks-api.json index 676f195fcee..96295b0beea 100644 --- a/cloudtasks/v2beta2/cloudtasks-api.json +++ b/cloudtasks/v2beta2/cloudtasks-api.json @@ -809,7 +809,7 @@ } } }, - "revision": "20211130", + "revision": "20220321", "rootUrl": "https://cloudtasks.googleapis.com/", "schemas": { "AcknowledgeTaskRequest": { @@ -1005,7 +1005,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/cloudtasks/v2beta2/cloudtasks-gen.go b/cloudtasks/v2beta2/cloudtasks-gen.go index 554453ad5ce..5c4573afe3c 100644 --- a/cloudtasks/v2beta2/cloudtasks-gen.go +++ b/cloudtasks/v2beta2/cloudtasks-gen.go @@ -727,8 +727,7 @@ func (s *CreateTaskRequest) 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. diff --git a/cloudtasks/v2beta3/cloudtasks-api.json b/cloudtasks/v2beta3/cloudtasks-api.json index e2cf5e77c16..397d4ce1868 100644 --- a/cloudtasks/v2beta3/cloudtasks-api.json +++ b/cloudtasks/v2beta3/cloudtasks-api.json @@ -697,7 +697,7 @@ } } }, - "revision": "20211130", + "revision": "20220321", "rootUrl": "https://cloudtasks.googleapis.com/", "schemas": { "AppEngineHttpQueue": { @@ -859,7 +859,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/cloudtasks/v2beta3/cloudtasks-gen.go b/cloudtasks/v2beta3/cloudtasks-gen.go index 71bbd2cc4ab..8f791f637a5 100644 --- a/cloudtasks/v2beta3/cloudtasks-gen.go +++ b/cloudtasks/v2beta3/cloudtasks-gen.go @@ -622,8 +622,7 @@ func (s *CreateTaskRequest) 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. diff --git a/documentai/v1/documentai-api.json b/documentai/v1/documentai-api.json index 1d1734adfad..8940aea0b7d 100644 --- a/documentai/v1/documentai-api.json +++ b/documentai/v1/documentai-api.json @@ -1947,7 +1947,7 @@ "description": "Optional. Provenance of the entity. Text anchor indexing into the Document.text." }, "type": { - "description": "Entity type from a schema e.g. `Address`.", + "description": "Required. Entity type from a schema e.g. `Address`.", "type": "string" } }, @@ -3192,6 +3192,10 @@ "description": "The display name of the processor version.", "type": "string" }, + "googleManaged": { + "description": "Denotes that this ProcessorVersion is managed by google.", + "type": "boolean" + }, "kmsKeyName": { "description": "The KMS key name used for encryption.", "type": "string" @@ -3586,7 +3590,7 @@ "description": "Optional. Provenance of the entity. Text anchor indexing into the Document.text." }, "type": { - "description": "Entity type from a schema e.g. `Address`.", + "description": "Required. Entity type from a schema e.g. `Address`.", "type": "string" } }, @@ -4783,7 +4787,7 @@ "description": "Optional. Provenance of the entity. Text anchor indexing into the Document.text." }, "type": { - "description": "Entity type from a schema e.g. `Address`.", + "description": "Required. Entity type from a schema e.g. `Address`.", "type": "string" } }, diff --git a/documentai/v1/documentai-gen.go b/documentai/v1/documentai-gen.go index e4f67edafc8..b113955d6ef 100644 --- a/documentai/v1/documentai-gen.go +++ b/documentai/v1/documentai-gen.go @@ -1869,7 +1869,7 @@ type GoogleCloudDocumentaiV1DocumentEntity struct { // into the Document.text. TextAnchor *GoogleCloudDocumentaiV1DocumentTextAnchor `json:"textAnchor,omitempty"` - // Type: Entity type from a schema e.g. `Address`. + // Type: Required. Entity type from a schema e.g. `Address`. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Confidence") to @@ -3975,6 +3975,10 @@ type GoogleCloudDocumentaiV1ProcessorVersion struct { // DisplayName: The display name of the processor version. DisplayName string `json:"displayName,omitempty"` + // GoogleManaged: Denotes that this ProcessorVersion is managed by + // google. + GoogleManaged bool `json:"googleManaged,omitempty"` + // KmsKeyName: The KMS key name used for encryption. KmsKeyName string `json:"kmsKeyName,omitempty"` @@ -4585,7 +4589,7 @@ type GoogleCloudDocumentaiV1beta1DocumentEntity struct { // into the Document.text. TextAnchor *GoogleCloudDocumentaiV1beta1DocumentTextAnchor `json:"textAnchor,omitempty"` - // Type: Entity type from a schema e.g. `Address`. + // Type: Required. Entity type from a schema e.g. `Address`. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Confidence") to @@ -6509,7 +6513,7 @@ type GoogleCloudDocumentaiV1beta2DocumentEntity struct { // into the Document.text. TextAnchor *GoogleCloudDocumentaiV1beta2DocumentTextAnchor `json:"textAnchor,omitempty"` - // Type: Entity type from a schema e.g. `Address`. + // Type: Required. Entity type from a schema e.g. `Address`. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Confidence") to diff --git a/documentai/v1beta2/documentai-api.json b/documentai/v1beta2/documentai-api.json index 02e97f8e377..026f76c6471 100644 --- a/documentai/v1beta2/documentai-api.json +++ b/documentai/v1beta2/documentai-api.json @@ -1344,7 +1344,7 @@ "description": "Optional. Provenance of the entity. Text anchor indexing into the Document.text." }, "type": { - "description": "Entity type from a schema e.g. `Address`.", + "description": "Required. Entity type from a schema e.g. `Address`.", "type": "string" } }, @@ -2566,7 +2566,7 @@ "description": "Optional. Provenance of the entity. Text anchor indexing into the Document.text." }, "type": { - "description": "Entity type from a schema e.g. `Address`.", + "description": "Required. Entity type from a schema e.g. `Address`.", "type": "string" } }, diff --git a/documentai/v1beta2/documentai-gen.go b/documentai/v1beta2/documentai-gen.go index eb45e361b2c..997cbc575d5 100644 --- a/documentai/v1beta2/documentai-gen.go +++ b/documentai/v1beta2/documentai-gen.go @@ -2051,7 +2051,7 @@ type GoogleCloudDocumentaiV1beta1DocumentEntity struct { // into the Document.text. TextAnchor *GoogleCloudDocumentaiV1beta1DocumentTextAnchor `json:"textAnchor,omitempty"` - // Type: Entity type from a schema e.g. `Address`. + // Type: Required. Entity type from a schema e.g. `Address`. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Confidence") to @@ -4039,7 +4039,7 @@ type GoogleCloudDocumentaiV1beta2DocumentEntity struct { // into the Document.text. TextAnchor *GoogleCloudDocumentaiV1beta2DocumentTextAnchor `json:"textAnchor,omitempty"` - // Type: Entity type from a schema e.g. `Address`. + // Type: Required. Entity type from a schema e.g. `Address`. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Confidence") to diff --git a/documentai/v1beta3/documentai-api.json b/documentai/v1beta3/documentai-api.json index 655e0de542d..6a9ce968727 100644 --- a/documentai/v1beta3/documentai-api.json +++ b/documentai/v1beta3/documentai-api.json @@ -1848,7 +1848,7 @@ "description": "Optional. Provenance of the entity. Text anchor indexing into the Document.text." }, "type": { - "description": "Entity type from a schema e.g. `Address`.", + "description": "Required. Entity type from a schema e.g. `Address`.", "type": "string" } }, @@ -3045,7 +3045,7 @@ "description": "Optional. Provenance of the entity. Text anchor indexing into the Document.text." }, "type": { - "description": "Entity type from a schema e.g. `Address`.", + "description": "Required. Entity type from a schema e.g. `Address`.", "type": "string" } }, @@ -4513,7 +4513,7 @@ "description": "Optional. Provenance of the entity. Text anchor indexing into the Document.text." }, "type": { - "description": "Entity type from a schema e.g. `Address`.", + "description": "Required. Entity type from a schema e.g. `Address`.", "type": "string" } }, @@ -5766,6 +5766,10 @@ "description": "The display name of the processor version.", "type": "string" }, + "googleManaged": { + "description": "Denotes that this ProcessorVersion is managed by google.", + "type": "boolean" + }, "kmsKeyName": { "description": "The KMS key name used for encryption.", "type": "string" diff --git a/documentai/v1beta3/documentai-gen.go b/documentai/v1beta3/documentai-gen.go index 56e6445d7e6..0f201f6ccd5 100644 --- a/documentai/v1beta3/documentai-gen.go +++ b/documentai/v1beta3/documentai-gen.go @@ -2051,7 +2051,7 @@ type GoogleCloudDocumentaiV1beta1DocumentEntity struct { // into the Document.text. TextAnchor *GoogleCloudDocumentaiV1beta1DocumentTextAnchor `json:"textAnchor,omitempty"` - // Type: Entity type from a schema e.g. `Address`. + // Type: Required. Entity type from a schema e.g. `Address`. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Confidence") to @@ -3975,7 +3975,7 @@ type GoogleCloudDocumentaiV1beta2DocumentEntity struct { // into the Document.text. TextAnchor *GoogleCloudDocumentaiV1beta2DocumentTextAnchor `json:"textAnchor,omitempty"` - // Type: Entity type from a schema e.g. `Address`. + // Type: Required. Entity type from a schema e.g. `Address`. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Confidence") to @@ -6375,7 +6375,7 @@ type GoogleCloudDocumentaiV1beta3DocumentEntity struct { // into the Document.text. TextAnchor *GoogleCloudDocumentaiV1beta3DocumentTextAnchor `json:"textAnchor,omitempty"` - // Type: Entity type from a schema e.g. `Address`. + // Type: Required. Entity type from a schema e.g. `Address`. Type string `json:"type,omitempty"` // ForceSendFields is a list of field names (e.g. "Confidence") to @@ -8493,6 +8493,10 @@ type GoogleCloudDocumentaiV1beta3ProcessorVersion struct { // DisplayName: The display name of the processor version. DisplayName string `json:"displayName,omitempty"` + // GoogleManaged: Denotes that this ProcessorVersion is managed by + // google. + GoogleManaged bool `json:"googleManaged,omitempty"` + // KmsKeyName: The KMS key name used for encryption. KmsKeyName string `json:"kmsKeyName,omitempty"` diff --git a/firebaserules/v1/firebaserules-api.json b/firebaserules/v1/firebaserules-api.json index b2777d39767..bc8fe3f9a28 100644 --- a/firebaserules/v1/firebaserules-api.json +++ b/firebaserules/v1/firebaserules-api.json @@ -477,7 +477,7 @@ } } }, - "revision": "20220127", + "revision": "20220323", "rootUrl": "https://firebaserules.googleapis.com/", "schemas": { "Arg": { @@ -496,7 +496,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/firebaserules/v1/firebaserules-gen.go b/firebaserules/v1/firebaserules-gen.go index 2bdd84187d6..126027f67bc 100644 --- a/firebaserules/v1/firebaserules-gen.go +++ b/firebaserules/v1/firebaserules-gen.go @@ -217,8 +217,7 @@ func (s *Arg) 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. diff --git a/forms/v1/forms-api.json b/forms/v1/forms-api.json index bd367fc113d..cf1da63a944 100644 --- a/forms/v1/forms-api.json +++ b/forms/v1/forms-api.json @@ -10,6 +10,15 @@ }, "https://www.googleapis.com/auth/drive.readonly": { "description": "See and download all your Google Drive files" + }, + "https://www.googleapis.com/auth/forms.body": { + "description": "See, edit, create, and delete all your Google Forms forms" + }, + "https://www.googleapis.com/auth/forms.body.readonly": { + "description": "See all your Google Forms forms" + }, + "https://www.googleapis.com/auth/forms.responses.readonly": { + "description": "See all responses to your Google Forms forms" } } } @@ -138,7 +147,8 @@ }, "scopes": [ "https://www.googleapis.com/auth/drive", - "https://www.googleapis.com/auth/drive.file" + "https://www.googleapis.com/auth/drive.file", + "https://www.googleapis.com/auth/forms.body" ] }, "create": { @@ -157,7 +167,8 @@ }, "scopes": [ "https://www.googleapis.com/auth/drive", - "https://www.googleapis.com/auth/drive.file" + "https://www.googleapis.com/auth/drive.file", + "https://www.googleapis.com/auth/forms.body" ] }, "get": { @@ -183,7 +194,9 @@ "scopes": [ "https://www.googleapis.com/auth/drive", "https://www.googleapis.com/auth/drive.file", - "https://www.googleapis.com/auth/drive.readonly" + "https://www.googleapis.com/auth/drive.readonly", + "https://www.googleapis.com/auth/forms.body", + "https://www.googleapis.com/auth/forms.body.readonly" ] } }, @@ -219,7 +232,8 @@ }, "scopes": [ "https://www.googleapis.com/auth/drive", - "https://www.googleapis.com/auth/drive.file" + "https://www.googleapis.com/auth/drive.file", + "https://www.googleapis.com/auth/forms.responses.readonly" ] }, "list": { @@ -260,7 +274,8 @@ }, "scopes": [ "https://www.googleapis.com/auth/drive", - "https://www.googleapis.com/auth/drive.file" + "https://www.googleapis.com/auth/drive.file", + "https://www.googleapis.com/auth/forms.responses.readonly" ] } } @@ -293,7 +308,10 @@ "scopes": [ "https://www.googleapis.com/auth/drive", "https://www.googleapis.com/auth/drive.file", - "https://www.googleapis.com/auth/drive.readonly" + "https://www.googleapis.com/auth/drive.readonly", + "https://www.googleapis.com/auth/forms.body", + "https://www.googleapis.com/auth/forms.body.readonly", + "https://www.googleapis.com/auth/forms.responses.readonly" ] }, "delete": { @@ -326,7 +344,10 @@ "scopes": [ "https://www.googleapis.com/auth/drive", "https://www.googleapis.com/auth/drive.file", - "https://www.googleapis.com/auth/drive.readonly" + "https://www.googleapis.com/auth/drive.readonly", + "https://www.googleapis.com/auth/forms.body", + "https://www.googleapis.com/auth/forms.body.readonly", + "https://www.googleapis.com/auth/forms.responses.readonly" ] }, "list": { @@ -352,7 +373,10 @@ "scopes": [ "https://www.googleapis.com/auth/drive", "https://www.googleapis.com/auth/drive.file", - "https://www.googleapis.com/auth/drive.readonly" + "https://www.googleapis.com/auth/drive.readonly", + "https://www.googleapis.com/auth/forms.body", + "https://www.googleapis.com/auth/forms.body.readonly", + "https://www.googleapis.com/auth/forms.responses.readonly" ] }, "renew": { @@ -388,7 +412,10 @@ "scopes": [ "https://www.googleapis.com/auth/drive", "https://www.googleapis.com/auth/drive.file", - "https://www.googleapis.com/auth/drive.readonly" + "https://www.googleapis.com/auth/drive.readonly", + "https://www.googleapis.com/auth/forms.body", + "https://www.googleapis.com/auth/forms.body.readonly", + "https://www.googleapis.com/auth/forms.responses.readonly" ] } } @@ -396,7 +423,7 @@ } } }, - "revision": "20220322", + "revision": "20220329", "rootUrl": "https://forms.googleapis.com/", "schemas": { "Answer": { diff --git a/forms/v1/forms-gen.go b/forms/v1/forms-gen.go index f2d1a3b3529..48c221058d5 100644 --- a/forms/v1/forms-gen.go +++ b/forms/v1/forms-gen.go @@ -25,7 +25,7 @@ // // By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes: // -// formsService, err := forms.NewService(ctx, option.WithScopes(forms.DriveReadonlyScope)) +// formsService, err := forms.NewService(ctx, option.WithScopes(forms.FormsResponsesReadonlyScope)) // // To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey: // @@ -93,6 +93,15 @@ const ( // See and download all your Google Drive files DriveReadonlyScope = "https://www.googleapis.com/auth/drive.readonly" + + // See, edit, create, and delete all your Google Forms forms + FormsBodyScope = "https://www.googleapis.com/auth/forms.body" + + // See all your Google Forms forms + FormsBodyReadonlyScope = "https://www.googleapis.com/auth/forms.body.readonly" + + // See all responses to your Google Forms forms + FormsResponsesReadonlyScope = "https://www.googleapis.com/auth/forms.responses.readonly" ) // NewService creates a new Service. @@ -101,6 +110,9 @@ func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, err "https://www.googleapis.com/auth/drive", "https://www.googleapis.com/auth/drive.file", "https://www.googleapis.com/auth/drive.readonly", + "https://www.googleapis.com/auth/forms.body", + "https://www.googleapis.com/auth/forms.body.readonly", + "https://www.googleapis.com/auth/forms.responses.readonly", ) // NOTE: prepend, so we don't override user-specified scopes. opts = append([]option.ClientOption{scopesOption}, opts...) @@ -2472,7 +2484,8 @@ func (c *FormsBatchUpdateCall) Do(opts ...googleapi.CallOption) (*BatchUpdateFor // }, // "scopes": [ // "https://www.googleapis.com/auth/drive", - // "https://www.googleapis.com/auth/drive.file" + // "https://www.googleapis.com/auth/drive.file", + // "https://www.googleapis.com/auth/forms.body" // ] // } @@ -2604,7 +2617,8 @@ func (c *FormsCreateCall) Do(opts ...googleapi.CallOption) (*Form, error) { // }, // "scopes": [ // "https://www.googleapis.com/auth/drive", - // "https://www.googleapis.com/auth/drive.file" + // "https://www.googleapis.com/auth/drive.file", + // "https://www.googleapis.com/auth/forms.body" // ] // } @@ -2751,7 +2765,9 @@ func (c *FormsGetCall) Do(opts ...googleapi.CallOption) (*Form, error) { // "scopes": [ // "https://www.googleapis.com/auth/drive", // "https://www.googleapis.com/auth/drive.file", - // "https://www.googleapis.com/auth/drive.readonly" + // "https://www.googleapis.com/auth/drive.readonly", + // "https://www.googleapis.com/auth/forms.body", + // "https://www.googleapis.com/auth/forms.body.readonly" // ] // } @@ -2908,7 +2924,8 @@ func (c *FormsResponsesGetCall) Do(opts ...googleapi.CallOption) (*FormResponse, // }, // "scopes": [ // "https://www.googleapis.com/auth/drive", - // "https://www.googleapis.com/auth/drive.file" + // "https://www.googleapis.com/auth/drive.file", + // "https://www.googleapis.com/auth/forms.responses.readonly" // ] // } @@ -3100,7 +3117,8 @@ func (c *FormsResponsesListCall) Do(opts ...googleapi.CallOption) (*ListFormResp // }, // "scopes": [ // "https://www.googleapis.com/auth/drive", - // "https://www.googleapis.com/auth/drive.file" + // "https://www.googleapis.com/auth/drive.file", + // "https://www.googleapis.com/auth/forms.responses.readonly" // ] // } @@ -3267,7 +3285,10 @@ func (c *FormsWatchesCreateCall) Do(opts ...googleapi.CallOption) (*Watch, error // "scopes": [ // "https://www.googleapis.com/auth/drive", // "https://www.googleapis.com/auth/drive.file", - // "https://www.googleapis.com/auth/drive.readonly" + // "https://www.googleapis.com/auth/drive.readonly", + // "https://www.googleapis.com/auth/forms.body", + // "https://www.googleapis.com/auth/forms.body.readonly", + // "https://www.googleapis.com/auth/forms.responses.readonly" // ] // } @@ -3411,7 +3432,10 @@ func (c *FormsWatchesDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error // "scopes": [ // "https://www.googleapis.com/auth/drive", // "https://www.googleapis.com/auth/drive.file", - // "https://www.googleapis.com/auth/drive.readonly" + // "https://www.googleapis.com/auth/drive.readonly", + // "https://www.googleapis.com/auth/forms.body", + // "https://www.googleapis.com/auth/forms.body.readonly", + // "https://www.googleapis.com/auth/forms.responses.readonly" // ] // } @@ -3560,7 +3584,10 @@ func (c *FormsWatchesListCall) Do(opts ...googleapi.CallOption) (*ListWatchesRes // "scopes": [ // "https://www.googleapis.com/auth/drive", // "https://www.googleapis.com/auth/drive.file", - // "https://www.googleapis.com/auth/drive.readonly" + // "https://www.googleapis.com/auth/drive.readonly", + // "https://www.googleapis.com/auth/forms.body", + // "https://www.googleapis.com/auth/forms.body.readonly", + // "https://www.googleapis.com/auth/forms.responses.readonly" // ] // } @@ -3718,7 +3745,10 @@ func (c *FormsWatchesRenewCall) Do(opts ...googleapi.CallOption) (*Watch, error) // "scopes": [ // "https://www.googleapis.com/auth/drive", // "https://www.googleapis.com/auth/drive.file", - // "https://www.googleapis.com/auth/drive.readonly" + // "https://www.googleapis.com/auth/drive.readonly", + // "https://www.googleapis.com/auth/forms.body", + // "https://www.googleapis.com/auth/forms.body.readonly", + // "https://www.googleapis.com/auth/forms.responses.readonly" // ] // } diff --git a/iam/v1/iam-api.json b/iam/v1/iam-api.json index 2c210686fe3..862bcee7120 100644 --- a/iam/v1/iam-api.json +++ b/iam/v1/iam-api.json @@ -1921,7 +1921,7 @@ } } }, - "revision": "20220310", + "revision": "20220324", "rootUrl": "https://iam.googleapis.com/", "schemas": { "AdminAuditData": { @@ -2149,7 +2149,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/iam/v1/iam-gen.go b/iam/v1/iam-gen.go index e58ce48541c..f64240d12f5 100644 --- a/iam/v1/iam-gen.go +++ b/iam/v1/iam-gen.go @@ -902,8 +902,7 @@ type DisableServiceAccountRequest struct { // 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. diff --git a/lifesciences/v2beta/lifesciences-api.json b/lifesciences/v2beta/lifesciences-api.json index dbf7c5102fa..8301a8405dc 100644 --- a/lifesciences/v2beta/lifesciences-api.json +++ b/lifesciences/v2beta/lifesciences-api.json @@ -312,7 +312,7 @@ } } }, - "revision": "20210813", + "revision": "20220325", "rootUrl": "https://lifesciences.googleapis.com/", "schemas": { "Accelerator": { @@ -541,7 +541,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/lifesciences/v2beta/lifesciences-gen.go b/lifesciences/v2beta/lifesciences-gen.go index 4f75fd45856..68503b88e05 100644 --- a/lifesciences/v2beta/lifesciences-gen.go +++ b/lifesciences/v2beta/lifesciences-gen.go @@ -602,8 +602,7 @@ func (s *Disk) 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. diff --git a/monitoring/v1/monitoring-api.json b/monitoring/v1/monitoring-api.json index 17f596b33c1..e148c807f4f 100644 --- a/monitoring/v1/monitoring-api.json +++ b/monitoring/v1/monitoring-api.json @@ -679,7 +679,7 @@ } } }, - "revision": "20220322", + "revision": "20220327", "rootUrl": "https://monitoring.googleapis.com/", "schemas": { "Aggregation": { @@ -894,6 +894,13 @@ "$ref": "ColumnLayout", "description": "The content is divided into equally spaced columns and the widgets are arranged vertically." }, + "dashboardFilters": { + "description": "Filters to reduce the amount of data charted based on the filter criteria.", + "items": { + "$ref": "DashboardFilter" + }, + "type": "array" + }, "displayName": { "description": "Required. The mutable, human-readable name.", "type": "string" @@ -928,6 +935,45 @@ }, "type": "object" }, + "DashboardFilter": { + "description": "A filter to reduce the amount of data charted in relevant widgets.", + "id": "DashboardFilter", + "properties": { + "filterType": { + "description": "The specified filter type", + "enum": [ + "FILTER_TYPE_UNSPECIFIED", + "RESOURCE_LABEL", + "METRIC_LABEL", + "USER_METADATA_LABEL", + "SYSTEM_METADATA_LABEL", + "GROUP" + ], + "enumDescriptions": [ + "Filter type is unspecified. This is not valid in a well-formed request.", + "Filter on a resource label value", + "Filter on a metrics label value", + "Filter on a user metadata label value", + "Filter on a system metadata label value", + "Filter on a group id" + ], + "type": "string" + }, + "labelKey": { + "description": "Required. The key for the label", + "type": "string" + }, + "stringValue": { + "description": "A variable-length string value.", + "type": "string" + }, + "templateVariable": { + "description": "The placeholder text that can be referenced in a filter string or MQL query. If omitted, the dashboard filter will be applied to all relevant widgets in the dashboard.", + "type": "string" + } + }, + "type": "object" + }, "DataSet": { "description": "Groups a time series query definition with charting options.", "id": "DataSet", diff --git a/monitoring/v1/monitoring-gen.go b/monitoring/v1/monitoring-gen.go index 9b6960ab3d3..82fde520751 100644 --- a/monitoring/v1/monitoring-gen.go +++ b/monitoring/v1/monitoring-gen.go @@ -785,6 +785,10 @@ type Dashboard struct { // the widgets are arranged vertically. ColumnLayout *ColumnLayout `json:"columnLayout,omitempty"` + // DashboardFilters: Filters to reduce the amount of data charted based + // on the filter criteria. + DashboardFilters []*DashboardFilter `json:"dashboardFilters,omitempty"` + // DisplayName: Required. The mutable, human-readable name. DisplayName string `json:"displayName,omitempty"` @@ -842,6 +846,55 @@ func (s *Dashboard) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// DashboardFilter: A filter to reduce the amount of data charted in +// relevant widgets. +type DashboardFilter struct { + // FilterType: The specified filter type + // + // Possible values: + // "FILTER_TYPE_UNSPECIFIED" - Filter type is unspecified. This is not + // valid in a well-formed request. + // "RESOURCE_LABEL" - Filter on a resource label value + // "METRIC_LABEL" - Filter on a metrics label value + // "USER_METADATA_LABEL" - Filter on a user metadata label value + // "SYSTEM_METADATA_LABEL" - Filter on a system metadata label value + // "GROUP" - Filter on a group id + FilterType string `json:"filterType,omitempty"` + + // LabelKey: Required. The key for the label + LabelKey string `json:"labelKey,omitempty"` + + // StringValue: A variable-length string value. + StringValue string `json:"stringValue,omitempty"` + + // TemplateVariable: The placeholder text that can be referenced in a + // filter string or MQL query. If omitted, the dashboard filter will be + // applied to all relevant widgets in the dashboard. + TemplateVariable string `json:"templateVariable,omitempty"` + + // ForceSendFields is a list of field names (e.g. "FilterType") 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. "FilterType") 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 *DashboardFilter) MarshalJSON() ([]byte, error) { + type NoMethod DashboardFilter + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // DataSet: Groups a time series query definition with charting options. type DataSet struct { // LegendTemplate: A template string for naming TimeSeries in the diff --git a/recommender/v1/recommender-api.json b/recommender/v1/recommender-api.json index 7bdb8b781f5..690ea31830d 100644 --- a/recommender/v1/recommender-api.json +++ b/recommender/v1/recommender-api.json @@ -646,72 +646,6 @@ "locations": { "resources": { "insightTypes": { - "methods": { - "getConfig": { - "description": "Gets the requested InsightTypeConfig. There is only one instance of the config for each InsightType.", - "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/insightTypes/{insightTypesId}/config", - "httpMethod": "GET", - "id": "recommender.organizations.locations.insightTypes.getConfig", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Required. Name of the InsightTypeConfig to get. Acceptable formats: * `projects/[PROJECT_NUMBER]/locations/global/recommenders/[INSIGHT_TYPE_ID]/config` * `projects/[PROJECT_ID]/locations/global/recommenders/[INSIGHT_TYPE_ID]/config` * `organizations/[ORGANIZATION_ID]/locations/global/recommenders/[INSIGHT_TYPE_ID]/config`", - "location": "path", - "pattern": "^organizations/[^/]+/locations/[^/]+/insightTypes/[^/]+/config$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+name}", - "response": { - "$ref": "GoogleCloudRecommenderV1InsightTypeConfig" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, - "updateConfig": { - "description": "Updates an InsightTypeConfig change. This will create a new revision of the config.", - "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/insightTypes/{insightTypesId}/config", - "httpMethod": "PATCH", - "id": "recommender.organizations.locations.insightTypes.updateConfig", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Name of insight type config. Eg, projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config", - "location": "path", - "pattern": "^organizations/[^/]+/locations/[^/]+/insightTypes/[^/]+/config$", - "required": true, - "type": "string" - }, - "updateMask": { - "description": "The list of fields to be updated.", - "format": "google-fieldmask", - "location": "query", - "type": "string" - }, - "validateOnly": { - "description": "If true, validate the request and preview the change, but do not actually update it.", - "location": "query", - "type": "boolean" - } - }, - "path": "v1/{+name}", - "request": { - "$ref": "GoogleCloudRecommenderV1InsightTypeConfig" - }, - "response": { - "$ref": "GoogleCloudRecommenderV1InsightTypeConfig" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - } - }, "resources": { "insights": { "methods": { @@ -814,72 +748,6 @@ } }, "recommenders": { - "methods": { - "getConfig": { - "description": "Gets the requested Recommender Config. There is only one instance of the config for each Recommender.", - "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/recommenders/{recommendersId}/config", - "httpMethod": "GET", - "id": "recommender.organizations.locations.recommenders.getConfig", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Required. Name of the Recommendation Config to get. Acceptable formats: * `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config` * `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config` * `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config`", - "location": "path", - "pattern": "^organizations/[^/]+/locations/[^/]+/recommenders/[^/]+/config$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+name}", - "response": { - "$ref": "GoogleCloudRecommenderV1RecommenderConfig" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, - "updateConfig": { - "description": "Updates a Recommender Config. This will create a new revision of the config.", - "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/recommenders/{recommendersId}/config", - "httpMethod": "PATCH", - "id": "recommender.organizations.locations.recommenders.updateConfig", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Name of recommender config. Eg, projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config", - "location": "path", - "pattern": "^organizations/[^/]+/locations/[^/]+/recommenders/[^/]+/config$", - "required": true, - "type": "string" - }, - "updateMask": { - "description": "The list of fields to be updated.", - "format": "google-fieldmask", - "location": "query", - "type": "string" - }, - "validateOnly": { - "description": "If true, validate the request and preview the change, but do not actually update it.", - "location": "query", - "type": "boolean" - } - }, - "path": "v1/{+name}", - "request": { - "$ref": "GoogleCloudRecommenderV1RecommenderConfig" - }, - "response": { - "$ref": "GoogleCloudRecommenderV1RecommenderConfig" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - } - }, "resources": { "recommendations": { "methods": { @@ -1046,72 +914,6 @@ "locations": { "resources": { "insightTypes": { - "methods": { - "getConfig": { - "description": "Gets the requested InsightTypeConfig. There is only one instance of the config for each InsightType.", - "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/insightTypes/{insightTypesId}/config", - "httpMethod": "GET", - "id": "recommender.projects.locations.insightTypes.getConfig", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Required. Name of the InsightTypeConfig to get. Acceptable formats: * `projects/[PROJECT_NUMBER]/locations/global/recommenders/[INSIGHT_TYPE_ID]/config` * `projects/[PROJECT_ID]/locations/global/recommenders/[INSIGHT_TYPE_ID]/config` * `organizations/[ORGANIZATION_ID]/locations/global/recommenders/[INSIGHT_TYPE_ID]/config`", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/insightTypes/[^/]+/config$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+name}", - "response": { - "$ref": "GoogleCloudRecommenderV1InsightTypeConfig" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, - "updateConfig": { - "description": "Updates an InsightTypeConfig change. This will create a new revision of the config.", - "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/insightTypes/{insightTypesId}/config", - "httpMethod": "PATCH", - "id": "recommender.projects.locations.insightTypes.updateConfig", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Name of insight type config. Eg, projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/insightTypes/[^/]+/config$", - "required": true, - "type": "string" - }, - "updateMask": { - "description": "The list of fields to be updated.", - "format": "google-fieldmask", - "location": "query", - "type": "string" - }, - "validateOnly": { - "description": "If true, validate the request and preview the change, but do not actually update it.", - "location": "query", - "type": "boolean" - } - }, - "path": "v1/{+name}", - "request": { - "$ref": "GoogleCloudRecommenderV1InsightTypeConfig" - }, - "response": { - "$ref": "GoogleCloudRecommenderV1InsightTypeConfig" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - } - }, "resources": { "insights": { "methods": { @@ -1214,72 +1016,6 @@ } }, "recommenders": { - "methods": { - "getConfig": { - "description": "Gets the requested Recommender Config. There is only one instance of the config for each Recommender.", - "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/recommenders/{recommendersId}/config", - "httpMethod": "GET", - "id": "recommender.projects.locations.recommenders.getConfig", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Required. Name of the Recommendation Config to get. Acceptable formats: * `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config` * `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config` * `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config`", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/recommenders/[^/]+/config$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+name}", - "response": { - "$ref": "GoogleCloudRecommenderV1RecommenderConfig" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, - "updateConfig": { - "description": "Updates a Recommender Config. This will create a new revision of the config.", - "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/recommenders/{recommendersId}/config", - "httpMethod": "PATCH", - "id": "recommender.projects.locations.recommenders.updateConfig", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Name of recommender config. Eg, projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/recommenders/[^/]+/config$", - "required": true, - "type": "string" - }, - "updateMask": { - "description": "The list of fields to be updated.", - "format": "google-fieldmask", - "location": "query", - "type": "string" - }, - "validateOnly": { - "description": "If true, validate the request and preview the change, but do not actually update it.", - "location": "query", - "type": "boolean" - } - }, - "path": "v1/{+name}", - "request": { - "$ref": "GoogleCloudRecommenderV1RecommenderConfig" - }, - "response": { - "$ref": "GoogleCloudRecommenderV1RecommenderConfig" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - } - }, "resources": { "recommendations": { "methods": { @@ -1442,7 +1178,7 @@ } } }, - "revision": "20220321", + "revision": "20220327", "rootUrl": "https://recommender.googleapis.com/", "schemas": { "GoogleCloudRecommenderV1CostProjection": { @@ -1630,61 +1366,6 @@ }, "type": "object" }, - "GoogleCloudRecommenderV1InsightTypeConfig": { - "description": "Configuration for an InsightType.", - "id": "GoogleCloudRecommenderV1InsightTypeConfig", - "properties": { - "annotations": { - "additionalProperties": { - "type": "string" - }, - "description": "Allows clients to store small amounts of arbitrary data. Annotations must follow the Kubernetes syntax. The total size of all keys and values combined is limited to 256k. Key can have 2 segments: prefix (optional) and name (required), separated by a slash (/). Prefix must be a DNS subdomain. Name must be 63 characters or less, begin and end with alphanumerics, with dashes (-), underscores (_), dots (.), and alphanumerics between.", - "type": "object" - }, - "displayName": { - "description": "A user-settable field to provide a human-readable name to be used in user interfaces.", - "type": "string" - }, - "etag": { - "description": "Fingerprint of the InsightTypeConfig. Provides optimistic locking when updating.", - "type": "string" - }, - "insightTypeGenerationConfig": { - "$ref": "GoogleCloudRecommenderV1InsightTypeGenerationConfig", - "description": "InsightTypeGenerationConfig which configures the generation of insights for this insight type." - }, - "name": { - "description": "Name of insight type config. Eg, projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config", - "type": "string" - }, - "revisionId": { - "description": "Output only. Immutable. The revision ID of the config. A new revision is committed whenever the config is changed in any way. The format is an 8-character hexadecimal string.", - "readOnly": true, - "type": "string" - }, - "updateTime": { - "description": "Last time when the config was updated.", - "format": "google-datetime", - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudRecommenderV1InsightTypeGenerationConfig": { - "description": "A configuration to customize the generation of insights. Eg, customizing the lookback period considered when generating a insight.", - "id": "GoogleCloudRecommenderV1InsightTypeGenerationConfig", - "properties": { - "params": { - "additionalProperties": { - "description": "Properties of the object.", - "type": "any" - }, - "description": "Parameters for this InsightTypeGenerationConfig. These configs can be used by or are applied to all subtypes.", - "type": "object" - } - }, - "type": "object" - }, "GoogleCloudRecommenderV1ListInsightsResponse": { "description": "Response to the `ListInsights` method.", "id": "GoogleCloudRecommenderV1ListInsightsResponse", @@ -2003,61 +1684,6 @@ }, "type": "object" }, - "GoogleCloudRecommenderV1RecommenderConfig": { - "description": "Configuration for a Recommender.", - "id": "GoogleCloudRecommenderV1RecommenderConfig", - "properties": { - "annotations": { - "additionalProperties": { - "type": "string" - }, - "description": "Allows clients to store small amounts of arbitrary data. Annotations must follow the Kubernetes syntax. The total size of all keys and values combined is limited to 256k. Key can have 2 segments: prefix (optional) and name (required), separated by a slash (/). Prefix must be a DNS subdomain. Name must be 63 characters or less, begin and end with alphanumerics, with dashes (-), underscores (_), dots (.), and alphanumerics between.", - "type": "object" - }, - "displayName": { - "description": "A user-settable field to provide a human-readable name to be used in user interfaces.", - "type": "string" - }, - "etag": { - "description": "Fingerprint of the RecommenderConfig. Provides optimistic locking when updating.", - "type": "string" - }, - "name": { - "description": "Name of recommender config. Eg, projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config", - "type": "string" - }, - "recommenderGenerationConfig": { - "$ref": "GoogleCloudRecommenderV1RecommenderGenerationConfig", - "description": "RecommenderGenerationConfig which configures the Generation of recommendations for this recommender." - }, - "revisionId": { - "description": "Output only. Immutable. The revision ID of the config. A new revision is committed whenever the config is changed in any way. The format is an 8-character hexadecimal string.", - "readOnly": true, - "type": "string" - }, - "updateTime": { - "description": "Last time when the config was updated.", - "format": "google-datetime", - "type": "string" - } - }, - "type": "object" - }, - "GoogleCloudRecommenderV1RecommenderGenerationConfig": { - "description": "A Configuration to customize the generation of recommendations. Eg, customizing the lookback period considered when generating a recommendation.", - "id": "GoogleCloudRecommenderV1RecommenderGenerationConfig", - "properties": { - "params": { - "additionalProperties": { - "description": "Properties of the object.", - "type": "any" - }, - "description": "Parameters for this RecommenderGenerationConfig. These configs can be used by or are applied to all subtypes.", - "type": "object" - } - }, - "type": "object" - }, "GoogleCloudRecommenderV1SecurityProjection": { "description": "Contains various ways of describing the impact on Security.", "id": "GoogleCloudRecommenderV1SecurityProjection", diff --git a/recommender/v1/recommender-gen.go b/recommender/v1/recommender-gen.go index e8fc30310d7..0e0dc282a21 100644 --- a/recommender/v1/recommender-gen.go +++ b/recommender/v1/recommender-gen.go @@ -674,101 +674,6 @@ func (s *GoogleCloudRecommenderV1InsightStateInfo) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudRecommenderV1InsightTypeConfig: Configuration for an -// InsightType. -type GoogleCloudRecommenderV1InsightTypeConfig struct { - // Annotations: Allows clients to store small amounts of arbitrary data. - // Annotations must follow the Kubernetes syntax. The total size of all - // keys and values combined is limited to 256k. Key can have 2 segments: - // prefix (optional) and name (required), separated by a slash (/). - // Prefix must be a DNS subdomain. Name must be 63 characters or less, - // begin and end with alphanumerics, with dashes (-), underscores (_), - // dots (.), and alphanumerics between. - Annotations map[string]string `json:"annotations,omitempty"` - - // DisplayName: A user-settable field to provide a human-readable name - // to be used in user interfaces. - DisplayName string `json:"displayName,omitempty"` - - // Etag: Fingerprint of the InsightTypeConfig. Provides optimistic - // locking when updating. - Etag string `json:"etag,omitempty"` - - // InsightTypeGenerationConfig: InsightTypeGenerationConfig which - // configures the generation of insights for this insight type. - InsightTypeGenerationConfig *GoogleCloudRecommenderV1InsightTypeGenerationConfig `json:"insightTypeGenerationConfig,omitempty"` - - // Name: Name of insight type config. Eg, - // projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_T - // YPE_ID]/config - Name string `json:"name,omitempty"` - - // RevisionId: Output only. Immutable. The revision ID of the config. A - // new revision is committed whenever the config is changed in any way. - // The format is an 8-character hexadecimal string. - RevisionId string `json:"revisionId,omitempty"` - - // UpdateTime: Last time when the config was 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 *GoogleCloudRecommenderV1InsightTypeConfig) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudRecommenderV1InsightTypeConfig - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - -// GoogleCloudRecommenderV1InsightTypeGenerationConfig: A configuration -// to customize the generation of insights. Eg, customizing the lookback -// period considered when generating a insight. -type GoogleCloudRecommenderV1InsightTypeGenerationConfig struct { - // Params: Parameters for this InsightTypeGenerationConfig. These - // configs can be used by or are applied to all subtypes. - Params googleapi.RawMessage `json:"params,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Params") 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. "Params") 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 *GoogleCloudRecommenderV1InsightTypeGenerationConfig) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudRecommenderV1InsightTypeGenerationConfig - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // GoogleCloudRecommenderV1ListInsightsResponse: Response to the // `ListInsights` method. type GoogleCloudRecommenderV1ListInsightsResponse struct { @@ -1321,101 +1226,6 @@ func (s *GoogleCloudRecommenderV1RecommendationStateInfo) MarshalJSON() ([]byte, return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudRecommenderV1RecommenderConfig: Configuration for a -// Recommender. -type GoogleCloudRecommenderV1RecommenderConfig struct { - // Annotations: Allows clients to store small amounts of arbitrary data. - // Annotations must follow the Kubernetes syntax. The total size of all - // keys and values combined is limited to 256k. Key can have 2 segments: - // prefix (optional) and name (required), separated by a slash (/). - // Prefix must be a DNS subdomain. Name must be 63 characters or less, - // begin and end with alphanumerics, with dashes (-), underscores (_), - // dots (.), and alphanumerics between. - Annotations map[string]string `json:"annotations,omitempty"` - - // DisplayName: A user-settable field to provide a human-readable name - // to be used in user interfaces. - DisplayName string `json:"displayName,omitempty"` - - // Etag: Fingerprint of the RecommenderConfig. Provides optimistic - // locking when updating. - Etag string `json:"etag,omitempty"` - - // Name: Name of recommender config. Eg, - // projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMEND - // ER_ID]/config - Name string `json:"name,omitempty"` - - // RecommenderGenerationConfig: RecommenderGenerationConfig which - // configures the Generation of recommendations for this recommender. - RecommenderGenerationConfig *GoogleCloudRecommenderV1RecommenderGenerationConfig `json:"recommenderGenerationConfig,omitempty"` - - // RevisionId: Output only. Immutable. The revision ID of the config. A - // new revision is committed whenever the config is changed in any way. - // The format is an 8-character hexadecimal string. - RevisionId string `json:"revisionId,omitempty"` - - // UpdateTime: Last time when the config was 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 *GoogleCloudRecommenderV1RecommenderConfig) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudRecommenderV1RecommenderConfig - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - -// GoogleCloudRecommenderV1RecommenderGenerationConfig: A Configuration -// to customize the generation of recommendations. Eg, customizing the -// lookback period considered when generating a recommendation. -type GoogleCloudRecommenderV1RecommenderGenerationConfig struct { - // Params: Parameters for this RecommenderGenerationConfig. These - // configs can be used by or are applied to all subtypes. - Params googleapi.RawMessage `json:"params,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Params") 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. "Params") 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 *GoogleCloudRecommenderV1RecommenderGenerationConfig) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudRecommenderV1RecommenderGenerationConfig - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // GoogleCloudRecommenderV1SecurityProjection: Contains various ways of // describing the impact on Security. type GoogleCloudRecommenderV1SecurityProjection struct { @@ -4234,9 +4044,9 @@ func (c *FoldersLocationsRecommendersRecommendationsMarkSucceededCall) Do(opts . } -// method id "recommender.organizations.locations.insightTypes.getConfig": +// method id "recommender.organizations.locations.insightTypes.insights.get": -type OrganizationsLocationsInsightTypesGetConfigCall struct { +type OrganizationsLocationsInsightTypesInsightsGetCall struct { s *Service name string urlParams_ gensupport.URLParams @@ -4245,18 +4055,12 @@ type OrganizationsLocationsInsightTypesGetConfigCall struct { header_ http.Header } -// GetConfig: Gets the requested InsightTypeConfig. There is only one -// instance of the config for each InsightType. +// Get: Gets the requested insight. Requires the recommender.*.get IAM +// permission for the specified insight type. // -// - name: Name of the InsightTypeConfig to get. Acceptable formats: * -// `projects/[PROJECT_NUMBER]/locations/global/recommenders/[INSIGHT_TY -// PE_ID]/config` * -// `projects/[PROJECT_ID]/locations/global/recommenders/[INSIGHT_TYPE_I -// D]/config` * -// `organizations/[ORGANIZATION_ID]/locations/global/recommenders/[INSI -// GHT_TYPE_ID]/config`. -func (r *OrganizationsLocationsInsightTypesService) GetConfig(name string) *OrganizationsLocationsInsightTypesGetConfigCall { - c := &OrganizationsLocationsInsightTypesGetConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} +// - name: Name of the insight. +func (r *OrganizationsLocationsInsightTypesInsightsService) Get(name string) *OrganizationsLocationsInsightTypesInsightsGetCall { + c := &OrganizationsLocationsInsightTypesInsightsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name return c } @@ -4264,7 +4068,7 @@ func (r *OrganizationsLocationsInsightTypesService) GetConfig(name string) *Orga // Fields allows partial responses to be retrieved. See // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse // for more information. -func (c *OrganizationsLocationsInsightTypesGetConfigCall) Fields(s ...googleapi.Field) *OrganizationsLocationsInsightTypesGetConfigCall { +func (c *OrganizationsLocationsInsightTypesInsightsGetCall) Fields(s ...googleapi.Field) *OrganizationsLocationsInsightTypesInsightsGetCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -4274,7 +4078,7 @@ func (c *OrganizationsLocationsInsightTypesGetConfigCall) Fields(s ...googleapi. // 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 *OrganizationsLocationsInsightTypesGetConfigCall) IfNoneMatch(entityTag string) *OrganizationsLocationsInsightTypesGetConfigCall { +func (c *OrganizationsLocationsInsightTypesInsightsGetCall) IfNoneMatch(entityTag string) *OrganizationsLocationsInsightTypesInsightsGetCall { c.ifNoneMatch_ = entityTag return c } @@ -4282,21 +4086,21 @@ func (c *OrganizationsLocationsInsightTypesGetConfigCall) IfNoneMatch(entityTag // 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 *OrganizationsLocationsInsightTypesGetConfigCall) Context(ctx context.Context) *OrganizationsLocationsInsightTypesGetConfigCall { +func (c *OrganizationsLocationsInsightTypesInsightsGetCall) Context(ctx context.Context) *OrganizationsLocationsInsightTypesInsightsGetCall { 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 *OrganizationsLocationsInsightTypesGetConfigCall) Header() http.Header { +func (c *OrganizationsLocationsInsightTypesInsightsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *OrganizationsLocationsInsightTypesGetConfigCall) doRequest(alt string) (*http.Response, error) { +func (c *OrganizationsLocationsInsightTypesInsightsGetCall) 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_ { @@ -4322,16 +4126,14 @@ func (c *OrganizationsLocationsInsightTypesGetConfigCall) doRequest(alt string) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "recommender.organizations.locations.insightTypes.getConfig" call. -// Exactly one of *GoogleCloudRecommenderV1InsightTypeConfig or error -// will be non-nil. Any non-2xx status code is an error. Response -// headers are in either -// *GoogleCloudRecommenderV1InsightTypeConfig.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 *OrganizationsLocationsInsightTypesGetConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1InsightTypeConfig, error) { +// Do executes the "recommender.organizations.locations.insightTypes.insights.get" call. +// Exactly one of *GoogleCloudRecommenderV1Insight or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *GoogleCloudRecommenderV1Insight.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 *OrganizationsLocationsInsightTypesInsightsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1Insight, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -4350,7 +4152,7 @@ func (c *OrganizationsLocationsInsightTypesGetConfigCall) Do(opts ...googleapi.C if err := googleapi.CheckResponse(res); err != nil { return nil, err } - ret := &GoogleCloudRecommenderV1InsightTypeConfig{ + ret := &GoogleCloudRecommenderV1Insight{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -4362,25 +4164,25 @@ func (c *OrganizationsLocationsInsightTypesGetConfigCall) Do(opts ...googleapi.C } return ret, nil // { - // "description": "Gets the requested InsightTypeConfig. There is only one instance of the config for each InsightType.", - // "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/insightTypes/{insightTypesId}/config", + // "description": "Gets the requested insight. Requires the recommender.*.get IAM permission for the specified insight type.", + // "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/insightTypes/{insightTypesId}/insights/{insightsId}", // "httpMethod": "GET", - // "id": "recommender.organizations.locations.insightTypes.getConfig", + // "id": "recommender.organizations.locations.insightTypes.insights.get", // "parameterOrder": [ // "name" // ], // "parameters": { // "name": { - // "description": "Required. Name of the InsightTypeConfig to get. Acceptable formats: * `projects/[PROJECT_NUMBER]/locations/global/recommenders/[INSIGHT_TYPE_ID]/config` * `projects/[PROJECT_ID]/locations/global/recommenders/[INSIGHT_TYPE_ID]/config` * `organizations/[ORGANIZATION_ID]/locations/global/recommenders/[INSIGHT_TYPE_ID]/config`", + // "description": "Required. Name of the insight.", // "location": "path", - // "pattern": "^organizations/[^/]+/locations/[^/]+/insightTypes/[^/]+/config$", + // "pattern": "^organizations/[^/]+/locations/[^/]+/insightTypes/[^/]+/insights/[^/]+$", // "required": true, // "type": "string" // } // }, // "path": "v1/{+name}", // "response": { - // "$ref": "GoogleCloudRecommenderV1InsightTypeConfig" + // "$ref": "GoogleCloudRecommenderV1Insight" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -4389,108 +4191,144 @@ func (c *OrganizationsLocationsInsightTypesGetConfigCall) Do(opts ...googleapi.C } -// method id "recommender.organizations.locations.insightTypes.updateConfig": +// method id "recommender.organizations.locations.insightTypes.insights.list": -type OrganizationsLocationsInsightTypesUpdateConfigCall struct { - s *Service - name string - googlecloudrecommenderv1insighttypeconfig *GoogleCloudRecommenderV1InsightTypeConfig - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type OrganizationsLocationsInsightTypesInsightsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// UpdateConfig: Updates an InsightTypeConfig change. This will create a -// new revision of the config. +// List: Lists insights for the specified Cloud Resource. Requires the +// recommender.*.list IAM permission for the specified insight type. // -// - name: Name of insight type config. Eg, -// projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT -// _TYPE_ID]/config. -func (r *OrganizationsLocationsInsightTypesService) UpdateConfig(name string, googlecloudrecommenderv1insighttypeconfig *GoogleCloudRecommenderV1InsightTypeConfig) *OrganizationsLocationsInsightTypesUpdateConfigCall { - c := &OrganizationsLocationsInsightTypesUpdateConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.googlecloudrecommenderv1insighttypeconfig = googlecloudrecommenderv1insighttypeconfig +// - parent: The container resource on which to execute the request. +// Acceptable formats: * +// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH +// T_TYPE_ID]` * +// `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TY +// PE_ID]` * +// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy +// pes/[INSIGHT_TYPE_ID]` * +// `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE +// _ID]` * +// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[ +// INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations: +// https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to +// supported insight types: +// https://cloud.google.com/recommender/docs/insights/insight-types. +func (r *OrganizationsLocationsInsightTypesInsightsService) List(parent string) *OrganizationsLocationsInsightTypesInsightsListCall { + c := &OrganizationsLocationsInsightTypesInsightsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": Filter expression to +// restrict the insights returned. Supported filter fields: * +// `stateInfo.state` * `insightSubtype` * `severity` Examples: * +// `stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED` * +// `insightSubtype = PERMISSIONS_USAGE` * `severity = CRITICAL OR +// severity = HIGH` * `stateInfo.state = ACTIVE AND (severity = CRITICAL +// OR severity = HIGH)` (These expressions are based on the filter +// language described at https://google.aip.dev/160) +func (c *OrganizationsLocationsInsightTypesInsightsListCall) Filter(filter string) *OrganizationsLocationsInsightTypesInsightsListCall { + c.urlParams_.Set("filter", filter) return c } -// UpdateMask sets the optional parameter "updateMask": The list of -// fields to be updated. -func (c *OrganizationsLocationsInsightTypesUpdateConfigCall) UpdateMask(updateMask string) *OrganizationsLocationsInsightTypesUpdateConfigCall { - c.urlParams_.Set("updateMask", updateMask) +// PageSize sets the optional parameter "pageSize": The maximum number +// of results to return from this request. Non-positive values are +// ignored. If not specified, the server will determine the number of +// results to return. +func (c *OrganizationsLocationsInsightTypesInsightsListCall) PageSize(pageSize int64) *OrganizationsLocationsInsightTypesInsightsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c } -// ValidateOnly sets the optional parameter "validateOnly": If true, -// validate the request and preview the change, but do not actually -// update it. -func (c *OrganizationsLocationsInsightTypesUpdateConfigCall) ValidateOnly(validateOnly bool) *OrganizationsLocationsInsightTypesUpdateConfigCall { - c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) +// PageToken sets the optional parameter "pageToken": If present, +// retrieves the next batch of results from the preceding call to this +// method. `page_token` must be the value of `next_page_token` from the +// previous response. The values of other method parameters must be +// identical to those in the previous call. +func (c *OrganizationsLocationsInsightTypesInsightsListCall) PageToken(pageToken string) *OrganizationsLocationsInsightTypesInsightsListCall { + 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 *OrganizationsLocationsInsightTypesUpdateConfigCall) Fields(s ...googleapi.Field) *OrganizationsLocationsInsightTypesUpdateConfigCall { +func (c *OrganizationsLocationsInsightTypesInsightsListCall) Fields(s ...googleapi.Field) *OrganizationsLocationsInsightTypesInsightsListCall { 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 *OrganizationsLocationsInsightTypesInsightsListCall) IfNoneMatch(entityTag string) *OrganizationsLocationsInsightTypesInsightsListCall { + 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 *OrganizationsLocationsInsightTypesUpdateConfigCall) Context(ctx context.Context) *OrganizationsLocationsInsightTypesUpdateConfigCall { +func (c *OrganizationsLocationsInsightTypesInsightsListCall) Context(ctx context.Context) *OrganizationsLocationsInsightTypesInsightsListCall { 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 *OrganizationsLocationsInsightTypesUpdateConfigCall) Header() http.Header { +func (c *OrganizationsLocationsInsightTypesInsightsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } -func (c *OrganizationsLocationsInsightTypesUpdateConfigCall) doRequest(alt string) (*http.Response, error) { +func (c *OrganizationsLocationsInsightTypesInsightsListCall) 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.googlecloudrecommenderv1insighttypeconfig) - if err != nil { - return nil, err + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) } - reqHeaders.Set("Content-Type", "application/json") + var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/insights") urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) + 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, + "parent": c.parent, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } -// Do executes the "recommender.organizations.locations.insightTypes.updateConfig" call. -// Exactly one of *GoogleCloudRecommenderV1InsightTypeConfig or error +// Do executes the "recommender.organizations.locations.insightTypes.insights.list" call. +// Exactly one of *GoogleCloudRecommenderV1ListInsightsResponse or error // will be non-nil. Any non-2xx status code is an error. Response // headers are in either -// *GoogleCloudRecommenderV1InsightTypeConfig.ServerResponse.Header or -// (if a response was returned at all) in +// *GoogleCloudRecommenderV1ListInsightsResponse.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 *OrganizationsLocationsInsightTypesUpdateConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1InsightTypeConfig, error) { +func (c *OrganizationsLocationsInsightTypesInsightsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1ListInsightsResponse, error) { gensupport.SetOptions(c.urlParams_, opts...) res, err := c.doRequest("json") if res != nil && res.StatusCode == http.StatusNotModified { @@ -4509,7 +4347,7 @@ func (c *OrganizationsLocationsInsightTypesUpdateConfigCall) Do(opts ...googleap if err := googleapi.CheckResponse(res); err != nil { return nil, err } - ret := &GoogleCloudRecommenderV1InsightTypeConfig{ + ret := &GoogleCloudRecommenderV1ListInsightsResponse{ ServerResponse: googleapi.ServerResponse{ Header: res.Header, HTTPStatusCode: res.StatusCode, @@ -4521,397 +4359,41 @@ func (c *OrganizationsLocationsInsightTypesUpdateConfigCall) Do(opts ...googleap } return ret, nil // { - // "description": "Updates an InsightTypeConfig change. This will create a new revision of the config.", - // "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/insightTypes/{insightTypesId}/config", - // "httpMethod": "PATCH", - // "id": "recommender.organizations.locations.insightTypes.updateConfig", + // "description": "Lists insights for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified insight type.", + // "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/insightTypes/{insightTypesId}/insights", + // "httpMethod": "GET", + // "id": "recommender.organizations.locations.insightTypes.insights.list", // "parameterOrder": [ - // "name" + // "parent" // ], // "parameters": { - // "name": { - // "description": "Name of insight type config. Eg, projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config", - // "location": "path", - // "pattern": "^organizations/[^/]+/locations/[^/]+/insightTypes/[^/]+/config$", - // "required": true, + // "filter": { + // "description": "Optional. Filter expression to restrict the insights returned. Supported filter fields: * `stateInfo.state` * `insightSubtype` * `severity` Examples: * `stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED` * `insightSubtype = PERMISSIONS_USAGE` * `severity = CRITICAL OR severity = HIGH` * `stateInfo.state = ACTIVE AND (severity = CRITICAL OR severity = HIGH)` (These expressions are based on the filter language described at https://google.aip.dev/160)", + // "location": "query", // "type": "string" // }, - // "updateMask": { - // "description": "The list of fields to be updated.", - // "format": "google-fieldmask", + // "pageSize": { + // "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. If not specified, the server will determine the number of results to return.", + // "format": "int32", // "location": "query", - // "type": "string" + // "type": "integer" // }, - // "validateOnly": { - // "description": "If true, validate the request and preview the change, but do not actually update it.", + // "pageToken": { + // "description": "Optional. If present, retrieves the next batch of results from the preceding call to this method. `page_token` must be the value of `next_page_token` from the previous response. The values of other method parameters must be identical to those in the previous call.", // "location": "query", - // "type": "boolean" + // "type": "string" + // }, + // "parent": { + // "description": "Required. The container resource on which to execute the request. Acceptable formats: * `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]` * `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]` * `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]` * `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]` * `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations: https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to supported insight types: https://cloud.google.com/recommender/docs/insights/insight-types.", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/[^/]+/insightTypes/[^/]+$", + // "required": true, + // "type": "string" // } // }, - // "path": "v1/{+name}", - // "request": { - // "$ref": "GoogleCloudRecommenderV1InsightTypeConfig" - // }, + // "path": "v1/{+parent}/insights", // "response": { - // "$ref": "GoogleCloudRecommenderV1InsightTypeConfig" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform" - // ] - // } - -} - -// method id "recommender.organizations.locations.insightTypes.insights.get": - -type OrganizationsLocationsInsightTypesInsightsGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// Get: Gets the requested insight. Requires the recommender.*.get IAM -// permission for the specified insight type. -// -// - name: Name of the insight. -func (r *OrganizationsLocationsInsightTypesInsightsService) Get(name string) *OrganizationsLocationsInsightTypesInsightsGetCall { - c := &OrganizationsLocationsInsightTypesInsightsGetCall{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 *OrganizationsLocationsInsightTypesInsightsGetCall) Fields(s ...googleapi.Field) *OrganizationsLocationsInsightTypesInsightsGetCall { - 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 *OrganizationsLocationsInsightTypesInsightsGetCall) IfNoneMatch(entityTag string) *OrganizationsLocationsInsightTypesInsightsGetCall { - 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 *OrganizationsLocationsInsightTypesInsightsGetCall) Context(ctx context.Context) *OrganizationsLocationsInsightTypesInsightsGetCall { - 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 *OrganizationsLocationsInsightTypesInsightsGetCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *OrganizationsLocationsInsightTypesInsightsGetCall) 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, "v1/{+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 "recommender.organizations.locations.insightTypes.insights.get" call. -// Exactly one of *GoogleCloudRecommenderV1Insight or error will be -// non-nil. Any non-2xx status code is an error. Response headers are in -// either *GoogleCloudRecommenderV1Insight.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 *OrganizationsLocationsInsightTypesInsightsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1Insight, 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 := &GoogleCloudRecommenderV1Insight{ - 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 requested insight. Requires the recommender.*.get IAM permission for the specified insight type.", - // "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/insightTypes/{insightTypesId}/insights/{insightsId}", - // "httpMethod": "GET", - // "id": "recommender.organizations.locations.insightTypes.insights.get", - // "parameterOrder": [ - // "name" - // ], - // "parameters": { - // "name": { - // "description": "Required. Name of the insight.", - // "location": "path", - // "pattern": "^organizations/[^/]+/locations/[^/]+/insightTypes/[^/]+/insights/[^/]+$", - // "required": true, - // "type": "string" - // } - // }, - // "path": "v1/{+name}", - // "response": { - // "$ref": "GoogleCloudRecommenderV1Insight" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform" - // ] - // } - -} - -// method id "recommender.organizations.locations.insightTypes.insights.list": - -type OrganizationsLocationsInsightTypesInsightsListCall struct { - s *Service - parent string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// List: Lists insights for the specified Cloud Resource. Requires the -// recommender.*.list IAM permission for the specified insight type. -// -// - parent: The container resource on which to execute the request. -// Acceptable formats: * -// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH -// T_TYPE_ID]` * -// `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TY -// PE_ID]` * -// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy -// pes/[INSIGHT_TYPE_ID]` * -// `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE -// _ID]` * -// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[ -// INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations: -// https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to -// supported insight types: -// https://cloud.google.com/recommender/docs/insights/insight-types. -func (r *OrganizationsLocationsInsightTypesInsightsService) List(parent string) *OrganizationsLocationsInsightTypesInsightsListCall { - c := &OrganizationsLocationsInsightTypesInsightsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - return c -} - -// Filter sets the optional parameter "filter": Filter expression to -// restrict the insights returned. Supported filter fields: * -// `stateInfo.state` * `insightSubtype` * `severity` Examples: * -// `stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED` * -// `insightSubtype = PERMISSIONS_USAGE` * `severity = CRITICAL OR -// severity = HIGH` * `stateInfo.state = ACTIVE AND (severity = CRITICAL -// OR severity = HIGH)` (These expressions are based on the filter -// language described at https://google.aip.dev/160) -func (c *OrganizationsLocationsInsightTypesInsightsListCall) Filter(filter string) *OrganizationsLocationsInsightTypesInsightsListCall { - c.urlParams_.Set("filter", filter) - return c -} - -// PageSize sets the optional parameter "pageSize": The maximum number -// of results to return from this request. Non-positive values are -// ignored. If not specified, the server will determine the number of -// results to return. -func (c *OrganizationsLocationsInsightTypesInsightsListCall) PageSize(pageSize int64) *OrganizationsLocationsInsightTypesInsightsListCall { - c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) - return c -} - -// PageToken sets the optional parameter "pageToken": If present, -// retrieves the next batch of results from the preceding call to this -// method. `page_token` must be the value of `next_page_token` from the -// previous response. The values of other method parameters must be -// identical to those in the previous call. -func (c *OrganizationsLocationsInsightTypesInsightsListCall) PageToken(pageToken string) *OrganizationsLocationsInsightTypesInsightsListCall { - 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 *OrganizationsLocationsInsightTypesInsightsListCall) Fields(s ...googleapi.Field) *OrganizationsLocationsInsightTypesInsightsListCall { - 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 *OrganizationsLocationsInsightTypesInsightsListCall) IfNoneMatch(entityTag string) *OrganizationsLocationsInsightTypesInsightsListCall { - 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 *OrganizationsLocationsInsightTypesInsightsListCall) Context(ctx context.Context) *OrganizationsLocationsInsightTypesInsightsListCall { - 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 *OrganizationsLocationsInsightTypesInsightsListCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *OrganizationsLocationsInsightTypesInsightsListCall) 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, "v1/{+parent}/insights") - 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 "recommender.organizations.locations.insightTypes.insights.list" call. -// Exactly one of *GoogleCloudRecommenderV1ListInsightsResponse or error -// will be non-nil. Any non-2xx status code is an error. Response -// headers are in either -// *GoogleCloudRecommenderV1ListInsightsResponse.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 *OrganizationsLocationsInsightTypesInsightsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1ListInsightsResponse, 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 := &GoogleCloudRecommenderV1ListInsightsResponse{ - 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 insights for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified insight type.", - // "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/insightTypes/{insightTypesId}/insights", - // "httpMethod": "GET", - // "id": "recommender.organizations.locations.insightTypes.insights.list", - // "parameterOrder": [ - // "parent" - // ], - // "parameters": { - // "filter": { - // "description": "Optional. Filter expression to restrict the insights returned. Supported filter fields: * `stateInfo.state` * `insightSubtype` * `severity` Examples: * `stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED` * `insightSubtype = PERMISSIONS_USAGE` * `severity = CRITICAL OR severity = HIGH` * `stateInfo.state = ACTIVE AND (severity = CRITICAL OR severity = HIGH)` (These expressions are based on the filter language described at https://google.aip.dev/160)", - // "location": "query", - // "type": "string" - // }, - // "pageSize": { - // "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. If not specified, the server will determine the number of results to return.", - // "format": "int32", - // "location": "query", - // "type": "integer" - // }, - // "pageToken": { - // "description": "Optional. If present, retrieves the next batch of results from the preceding call to this method. `page_token` must be the value of `next_page_token` from the previous response. The values of other method parameters must be identical to those in the previous call.", - // "location": "query", - // "type": "string" - // }, - // "parent": { - // "description": "Required. The container resource on which to execute the request. Acceptable formats: * `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]` * `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]` * `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]` * `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]` * `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations: https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to supported insight types: https://cloud.google.com/recommender/docs/insights/insight-types.", - // "location": "path", - // "pattern": "^organizations/[^/]+/locations/[^/]+/insightTypes/[^/]+$", - // "required": true, - // "type": "string" - // } - // }, - // "path": "v1/{+parent}/insights", - // "response": { - // "$ref": "GoogleCloudRecommenderV1ListInsightsResponse" + // "$ref": "GoogleCloudRecommenderV1ListInsightsResponse" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -5074,341 +4556,12 @@ func (c *OrganizationsLocationsInsightTypesInsightsMarkAcceptedCall) Do(opts ... // "type": "string" // } // }, - // "path": "v1/{+name}:markAccepted", - // "request": { - // "$ref": "GoogleCloudRecommenderV1MarkInsightAcceptedRequest" - // }, - // "response": { - // "$ref": "GoogleCloudRecommenderV1Insight" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform" - // ] - // } - -} - -// method id "recommender.organizations.locations.recommenders.getConfig": - -type OrganizationsLocationsRecommendersGetConfigCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// GetConfig: Gets the requested Recommender Config. There is only one -// instance of the config for each Recommender. -// -// - name: Name of the Recommendation Config to get. Acceptable formats: -// * -// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM -// ENDER_ID]/config` * -// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE -// R_ID]/config` * -// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[ -// RECOMMENDER_ID]/config`. -func (r *OrganizationsLocationsRecommendersService) GetConfig(name string) *OrganizationsLocationsRecommendersGetConfigCall { - c := &OrganizationsLocationsRecommendersGetConfigCall{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 *OrganizationsLocationsRecommendersGetConfigCall) Fields(s ...googleapi.Field) *OrganizationsLocationsRecommendersGetConfigCall { - 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 *OrganizationsLocationsRecommendersGetConfigCall) IfNoneMatch(entityTag string) *OrganizationsLocationsRecommendersGetConfigCall { - 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 *OrganizationsLocationsRecommendersGetConfigCall) Context(ctx context.Context) *OrganizationsLocationsRecommendersGetConfigCall { - 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 *OrganizationsLocationsRecommendersGetConfigCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *OrganizationsLocationsRecommendersGetConfigCall) 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, "v1/{+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 "recommender.organizations.locations.recommenders.getConfig" call. -// Exactly one of *GoogleCloudRecommenderV1RecommenderConfig or error -// will be non-nil. Any non-2xx status code is an error. Response -// headers are in either -// *GoogleCloudRecommenderV1RecommenderConfig.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 *OrganizationsLocationsRecommendersGetConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1RecommenderConfig, 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 := &GoogleCloudRecommenderV1RecommenderConfig{ - 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 requested Recommender Config. There is only one instance of the config for each Recommender.", - // "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/recommenders/{recommendersId}/config", - // "httpMethod": "GET", - // "id": "recommender.organizations.locations.recommenders.getConfig", - // "parameterOrder": [ - // "name" - // ], - // "parameters": { - // "name": { - // "description": "Required. Name of the Recommendation Config to get. Acceptable formats: * `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config` * `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config` * `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config`", - // "location": "path", - // "pattern": "^organizations/[^/]+/locations/[^/]+/recommenders/[^/]+/config$", - // "required": true, - // "type": "string" - // } - // }, - // "path": "v1/{+name}", - // "response": { - // "$ref": "GoogleCloudRecommenderV1RecommenderConfig" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform" - // ] - // } - -} - -// method id "recommender.organizations.locations.recommenders.updateConfig": - -type OrganizationsLocationsRecommendersUpdateConfigCall struct { - s *Service - name string - googlecloudrecommenderv1recommenderconfig *GoogleCloudRecommenderV1RecommenderConfig - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// UpdateConfig: Updates a Recommender Config. This will create a new -// revision of the config. -// -// - name: Name of recommender config. Eg, -// projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMME -// NDER_ID]/config. -func (r *OrganizationsLocationsRecommendersService) UpdateConfig(name string, googlecloudrecommenderv1recommenderconfig *GoogleCloudRecommenderV1RecommenderConfig) *OrganizationsLocationsRecommendersUpdateConfigCall { - c := &OrganizationsLocationsRecommendersUpdateConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.googlecloudrecommenderv1recommenderconfig = googlecloudrecommenderv1recommenderconfig - return c -} - -// UpdateMask sets the optional parameter "updateMask": The list of -// fields to be updated. -func (c *OrganizationsLocationsRecommendersUpdateConfigCall) UpdateMask(updateMask string) *OrganizationsLocationsRecommendersUpdateConfigCall { - c.urlParams_.Set("updateMask", updateMask) - return c -} - -// ValidateOnly sets the optional parameter "validateOnly": If true, -// validate the request and preview the change, but do not actually -// update it. -func (c *OrganizationsLocationsRecommendersUpdateConfigCall) ValidateOnly(validateOnly bool) *OrganizationsLocationsRecommendersUpdateConfigCall { - c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) - 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 *OrganizationsLocationsRecommendersUpdateConfigCall) Fields(s ...googleapi.Field) *OrganizationsLocationsRecommendersUpdateConfigCall { - 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 *OrganizationsLocationsRecommendersUpdateConfigCall) Context(ctx context.Context) *OrganizationsLocationsRecommendersUpdateConfigCall { - 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 *OrganizationsLocationsRecommendersUpdateConfigCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *OrganizationsLocationsRecommendersUpdateConfigCall) 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.googlecloudrecommenderv1recommenderconfig) - if err != nil { - return nil, err - } - reqHeaders.Set("Content-Type", "application/json") - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "name": c.name, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "recommender.organizations.locations.recommenders.updateConfig" call. -// Exactly one of *GoogleCloudRecommenderV1RecommenderConfig or error -// will be non-nil. Any non-2xx status code is an error. Response -// headers are in either -// *GoogleCloudRecommenderV1RecommenderConfig.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 *OrganizationsLocationsRecommendersUpdateConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1RecommenderConfig, 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 := &GoogleCloudRecommenderV1RecommenderConfig{ - 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 a Recommender Config. This will create a new revision of the config.", - // "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/recommenders/{recommendersId}/config", - // "httpMethod": "PATCH", - // "id": "recommender.organizations.locations.recommenders.updateConfig", - // "parameterOrder": [ - // "name" - // ], - // "parameters": { - // "name": { - // "description": "Name of recommender config. Eg, projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config", - // "location": "path", - // "pattern": "^organizations/[^/]+/locations/[^/]+/recommenders/[^/]+/config$", - // "required": true, - // "type": "string" - // }, - // "updateMask": { - // "description": "The list of fields to be updated.", - // "format": "google-fieldmask", - // "location": "query", - // "type": "string" - // }, - // "validateOnly": { - // "description": "If true, validate the request and preview the change, but do not actually update it.", - // "location": "query", - // "type": "boolean" - // } - // }, - // "path": "v1/{+name}", + // "path": "v1/{+name}:markAccepted", // "request": { - // "$ref": "GoogleCloudRecommenderV1RecommenderConfig" + // "$ref": "GoogleCloudRecommenderV1MarkInsightAcceptedRequest" // }, // "response": { - // "$ref": "GoogleCloudRecommenderV1RecommenderConfig" + // "$ref": "GoogleCloudRecommenderV1Insight" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -6234,340 +5387,12 @@ func (c *OrganizationsLocationsRecommendersRecommendationsMarkSucceededCall) Do( // "type": "string" // } // }, - // "path": "v1/{+name}:markSucceeded", - // "request": { - // "$ref": "GoogleCloudRecommenderV1MarkRecommendationSucceededRequest" - // }, - // "response": { - // "$ref": "GoogleCloudRecommenderV1Recommendation" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform" - // ] - // } - -} - -// method id "recommender.projects.locations.insightTypes.getConfig": - -type ProjectsLocationsInsightTypesGetConfigCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// GetConfig: Gets the requested InsightTypeConfig. There is only one -// instance of the config for each InsightType. -// -// - name: Name of the InsightTypeConfig to get. Acceptable formats: * -// `projects/[PROJECT_NUMBER]/locations/global/recommenders/[INSIGHT_TY -// PE_ID]/config` * -// `projects/[PROJECT_ID]/locations/global/recommenders/[INSIGHT_TYPE_I -// D]/config` * -// `organizations/[ORGANIZATION_ID]/locations/global/recommenders/[INSI -// GHT_TYPE_ID]/config`. -func (r *ProjectsLocationsInsightTypesService) GetConfig(name string) *ProjectsLocationsInsightTypesGetConfigCall { - c := &ProjectsLocationsInsightTypesGetConfigCall{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 *ProjectsLocationsInsightTypesGetConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsInsightTypesGetConfigCall { - 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 *ProjectsLocationsInsightTypesGetConfigCall) IfNoneMatch(entityTag string) *ProjectsLocationsInsightTypesGetConfigCall { - 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 *ProjectsLocationsInsightTypesGetConfigCall) Context(ctx context.Context) *ProjectsLocationsInsightTypesGetConfigCall { - 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 *ProjectsLocationsInsightTypesGetConfigCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsInsightTypesGetConfigCall) 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, "v1/{+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 "recommender.projects.locations.insightTypes.getConfig" call. -// Exactly one of *GoogleCloudRecommenderV1InsightTypeConfig or error -// will be non-nil. Any non-2xx status code is an error. Response -// headers are in either -// *GoogleCloudRecommenderV1InsightTypeConfig.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 *ProjectsLocationsInsightTypesGetConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1InsightTypeConfig, 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 := &GoogleCloudRecommenderV1InsightTypeConfig{ - 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 requested InsightTypeConfig. There is only one instance of the config for each InsightType.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/insightTypes/{insightTypesId}/config", - // "httpMethod": "GET", - // "id": "recommender.projects.locations.insightTypes.getConfig", - // "parameterOrder": [ - // "name" - // ], - // "parameters": { - // "name": { - // "description": "Required. Name of the InsightTypeConfig to get. Acceptable formats: * `projects/[PROJECT_NUMBER]/locations/global/recommenders/[INSIGHT_TYPE_ID]/config` * `projects/[PROJECT_ID]/locations/global/recommenders/[INSIGHT_TYPE_ID]/config` * `organizations/[ORGANIZATION_ID]/locations/global/recommenders/[INSIGHT_TYPE_ID]/config`", - // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/insightTypes/[^/]+/config$", - // "required": true, - // "type": "string" - // } - // }, - // "path": "v1/{+name}", - // "response": { - // "$ref": "GoogleCloudRecommenderV1InsightTypeConfig" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform" - // ] - // } - -} - -// method id "recommender.projects.locations.insightTypes.updateConfig": - -type ProjectsLocationsInsightTypesUpdateConfigCall struct { - s *Service - name string - googlecloudrecommenderv1insighttypeconfig *GoogleCloudRecommenderV1InsightTypeConfig - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// UpdateConfig: Updates an InsightTypeConfig change. This will create a -// new revision of the config. -// -// - name: Name of insight type config. Eg, -// projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT -// _TYPE_ID]/config. -func (r *ProjectsLocationsInsightTypesService) UpdateConfig(name string, googlecloudrecommenderv1insighttypeconfig *GoogleCloudRecommenderV1InsightTypeConfig) *ProjectsLocationsInsightTypesUpdateConfigCall { - c := &ProjectsLocationsInsightTypesUpdateConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.googlecloudrecommenderv1insighttypeconfig = googlecloudrecommenderv1insighttypeconfig - return c -} - -// UpdateMask sets the optional parameter "updateMask": The list of -// fields to be updated. -func (c *ProjectsLocationsInsightTypesUpdateConfigCall) UpdateMask(updateMask string) *ProjectsLocationsInsightTypesUpdateConfigCall { - c.urlParams_.Set("updateMask", updateMask) - return c -} - -// ValidateOnly sets the optional parameter "validateOnly": If true, -// validate the request and preview the change, but do not actually -// update it. -func (c *ProjectsLocationsInsightTypesUpdateConfigCall) ValidateOnly(validateOnly bool) *ProjectsLocationsInsightTypesUpdateConfigCall { - c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) - 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 *ProjectsLocationsInsightTypesUpdateConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsInsightTypesUpdateConfigCall { - 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 *ProjectsLocationsInsightTypesUpdateConfigCall) Context(ctx context.Context) *ProjectsLocationsInsightTypesUpdateConfigCall { - 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 *ProjectsLocationsInsightTypesUpdateConfigCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsInsightTypesUpdateConfigCall) 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.googlecloudrecommenderv1insighttypeconfig) - if err != nil { - return nil, err - } - reqHeaders.Set("Content-Type", "application/json") - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "name": c.name, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "recommender.projects.locations.insightTypes.updateConfig" call. -// Exactly one of *GoogleCloudRecommenderV1InsightTypeConfig or error -// will be non-nil. Any non-2xx status code is an error. Response -// headers are in either -// *GoogleCloudRecommenderV1InsightTypeConfig.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 *ProjectsLocationsInsightTypesUpdateConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1InsightTypeConfig, 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 := &GoogleCloudRecommenderV1InsightTypeConfig{ - 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 an InsightTypeConfig change. This will create a new revision of the config.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/insightTypes/{insightTypesId}/config", - // "httpMethod": "PATCH", - // "id": "recommender.projects.locations.insightTypes.updateConfig", - // "parameterOrder": [ - // "name" - // ], - // "parameters": { - // "name": { - // "description": "Name of insight type config. Eg, projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config", - // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/insightTypes/[^/]+/config$", - // "required": true, - // "type": "string" - // }, - // "updateMask": { - // "description": "The list of fields to be updated.", - // "format": "google-fieldmask", - // "location": "query", - // "type": "string" - // }, - // "validateOnly": { - // "description": "If true, validate the request and preview the change, but do not actually update it.", - // "location": "query", - // "type": "boolean" - // } - // }, - // "path": "v1/{+name}", + // "path": "v1/{+name}:markSucceeded", // "request": { - // "$ref": "GoogleCloudRecommenderV1InsightTypeConfig" + // "$ref": "GoogleCloudRecommenderV1MarkRecommendationSucceededRequest" // }, // "response": { - // "$ref": "GoogleCloudRecommenderV1InsightTypeConfig" + // "$ref": "GoogleCloudRecommenderV1Recommendation" // }, // "scopes": [ // "https://www.googleapis.com/auth/cloud-platform" @@ -7102,335 +5927,6 @@ func (c *ProjectsLocationsInsightTypesInsightsMarkAcceptedCall) Do(opts ...googl } -// method id "recommender.projects.locations.recommenders.getConfig": - -type ProjectsLocationsRecommendersGetConfigCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// GetConfig: Gets the requested Recommender Config. There is only one -// instance of the config for each Recommender. -// -// - name: Name of the Recommendation Config to get. Acceptable formats: -// * -// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM -// ENDER_ID]/config` * -// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE -// R_ID]/config` * -// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[ -// RECOMMENDER_ID]/config`. -func (r *ProjectsLocationsRecommendersService) GetConfig(name string) *ProjectsLocationsRecommendersGetConfigCall { - c := &ProjectsLocationsRecommendersGetConfigCall{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 *ProjectsLocationsRecommendersGetConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsRecommendersGetConfigCall { - 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 *ProjectsLocationsRecommendersGetConfigCall) IfNoneMatch(entityTag string) *ProjectsLocationsRecommendersGetConfigCall { - 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 *ProjectsLocationsRecommendersGetConfigCall) Context(ctx context.Context) *ProjectsLocationsRecommendersGetConfigCall { - 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 *ProjectsLocationsRecommendersGetConfigCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsRecommendersGetConfigCall) 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, "v1/{+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 "recommender.projects.locations.recommenders.getConfig" call. -// Exactly one of *GoogleCloudRecommenderV1RecommenderConfig or error -// will be non-nil. Any non-2xx status code is an error. Response -// headers are in either -// *GoogleCloudRecommenderV1RecommenderConfig.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 *ProjectsLocationsRecommendersGetConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1RecommenderConfig, 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 := &GoogleCloudRecommenderV1RecommenderConfig{ - 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 requested Recommender Config. There is only one instance of the config for each Recommender.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/recommenders/{recommendersId}/config", - // "httpMethod": "GET", - // "id": "recommender.projects.locations.recommenders.getConfig", - // "parameterOrder": [ - // "name" - // ], - // "parameters": { - // "name": { - // "description": "Required. Name of the Recommendation Config to get. Acceptable formats: * `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config` * `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config` * `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config`", - // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/recommenders/[^/]+/config$", - // "required": true, - // "type": "string" - // } - // }, - // "path": "v1/{+name}", - // "response": { - // "$ref": "GoogleCloudRecommenderV1RecommenderConfig" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform" - // ] - // } - -} - -// method id "recommender.projects.locations.recommenders.updateConfig": - -type ProjectsLocationsRecommendersUpdateConfigCall struct { - s *Service - name string - googlecloudrecommenderv1recommenderconfig *GoogleCloudRecommenderV1RecommenderConfig - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// UpdateConfig: Updates a Recommender Config. This will create a new -// revision of the config. -// -// - name: Name of recommender config. Eg, -// projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMME -// NDER_ID]/config. -func (r *ProjectsLocationsRecommendersService) UpdateConfig(name string, googlecloudrecommenderv1recommenderconfig *GoogleCloudRecommenderV1RecommenderConfig) *ProjectsLocationsRecommendersUpdateConfigCall { - c := &ProjectsLocationsRecommendersUpdateConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.googlecloudrecommenderv1recommenderconfig = googlecloudrecommenderv1recommenderconfig - return c -} - -// UpdateMask sets the optional parameter "updateMask": The list of -// fields to be updated. -func (c *ProjectsLocationsRecommendersUpdateConfigCall) UpdateMask(updateMask string) *ProjectsLocationsRecommendersUpdateConfigCall { - c.urlParams_.Set("updateMask", updateMask) - return c -} - -// ValidateOnly sets the optional parameter "validateOnly": If true, -// validate the request and preview the change, but do not actually -// update it. -func (c *ProjectsLocationsRecommendersUpdateConfigCall) ValidateOnly(validateOnly bool) *ProjectsLocationsRecommendersUpdateConfigCall { - c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) - 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 *ProjectsLocationsRecommendersUpdateConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsRecommendersUpdateConfigCall { - 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 *ProjectsLocationsRecommendersUpdateConfigCall) Context(ctx context.Context) *ProjectsLocationsRecommendersUpdateConfigCall { - 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 *ProjectsLocationsRecommendersUpdateConfigCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsRecommendersUpdateConfigCall) 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.googlecloudrecommenderv1recommenderconfig) - if err != nil { - return nil, err - } - reqHeaders.Set("Content-Type", "application/json") - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "name": c.name, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "recommender.projects.locations.recommenders.updateConfig" call. -// Exactly one of *GoogleCloudRecommenderV1RecommenderConfig or error -// will be non-nil. Any non-2xx status code is an error. Response -// headers are in either -// *GoogleCloudRecommenderV1RecommenderConfig.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 *ProjectsLocationsRecommendersUpdateConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1RecommenderConfig, 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 := &GoogleCloudRecommenderV1RecommenderConfig{ - 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 a Recommender Config. This will create a new revision of the config.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/recommenders/{recommendersId}/config", - // "httpMethod": "PATCH", - // "id": "recommender.projects.locations.recommenders.updateConfig", - // "parameterOrder": [ - // "name" - // ], - // "parameters": { - // "name": { - // "description": "Name of recommender config. Eg, projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config", - // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/recommenders/[^/]+/config$", - // "required": true, - // "type": "string" - // }, - // "updateMask": { - // "description": "The list of fields to be updated.", - // "format": "google-fieldmask", - // "location": "query", - // "type": "string" - // }, - // "validateOnly": { - // "description": "If true, validate the request and preview the change, but do not actually update it.", - // "location": "query", - // "type": "boolean" - // } - // }, - // "path": "v1/{+name}", - // "request": { - // "$ref": "GoogleCloudRecommenderV1RecommenderConfig" - // }, - // "response": { - // "$ref": "GoogleCloudRecommenderV1RecommenderConfig" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform" - // ] - // } - -} - // method id "recommender.projects.locations.recommenders.recommendations.get": type ProjectsLocationsRecommendersRecommendationsGetCall struct { From 5bd40ca0231c9da64548cb7a8c915c31e2b88cae Mon Sep 17 00:00:00 2001 From: WhiteSource Renovate Date: Mon, 4 Apr 2022 15:36:36 +0200 Subject: [PATCH 03/17] chore(all): update all to 749bd19 (#1501) --- go.mod | 6 +++--- go.sum | 15 ++++++++------- 2 files changed, 11 insertions(+), 10 deletions(-) diff --git a/go.mod b/go.mod index 1425034f919..5a78fcb0076 100644 --- a/go.mod +++ b/go.mod @@ -7,12 +7,12 @@ require ( github.com/google/go-cmp v0.5.7 github.com/googleapis/gax-go/v2 v2.2.0 go.opencensus.io v0.23.0 - golang.org/x/net v0.0.0-20220325170049-de3da57026de + golang.org/x/net v0.0.0-20220403103023-749bd193bc2b golang.org/x/oauth2 v0.0.0-20220309155454-6242fa91716a golang.org/x/sync v0.0.0-20210220032951-036812b2e83c - golang.org/x/sys v0.0.0-20220328115105-d36c6a25d886 + golang.org/x/sys v0.0.0-20220403205710-6acee93ad0eb golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1 google.golang.org/appengine v1.6.7 - google.golang.org/genproto v0.0.0-20220324131243-acbaeb5b85eb + google.golang.org/genproto v0.0.0-20220401170504-314d38edb7de google.golang.org/grpc v1.45.0 ) diff --git a/go.sum b/go.sum index 7b2afc16141..75a4d5f720c 100644 --- a/go.sum +++ b/go.sum @@ -270,8 +270,8 @@ golang.org/x/net v0.0.0-20210405180319-a5a99cb37ef4/go.mod h1:p54w0d4576C0XHj96b golang.org/x/net v0.0.0-20210503060351-7fd8e65b6420/go.mod h1:9nx3DQGgdP8bBQD5qxJ1jj9UTztislL4KSBs9R2vV5Y= golang.org/x/net v0.0.0-20220127200216-cd36cc0744dd/go.mod h1:CfG3xpIq0wQ8r1q4Su4UZFWDARRcnwPjda9FqA0JpMk= golang.org/x/net v0.0.0-20220225172249-27dd8689420f/go.mod h1:CfG3xpIq0wQ8r1q4Su4UZFWDARRcnwPjda9FqA0JpMk= -golang.org/x/net v0.0.0-20220325170049-de3da57026de h1:pZB1TWnKi+o4bENlbzAgLrEbY4RMYmUIRobMcSmfeYc= -golang.org/x/net v0.0.0-20220325170049-de3da57026de/go.mod h1:CfG3xpIq0wQ8r1q4Su4UZFWDARRcnwPjda9FqA0JpMk= +golang.org/x/net v0.0.0-20220403103023-749bd193bc2b h1:vI32FkLJNAWtGD4BwkThwEy6XS7ZLLMHkSkYfF8M0W0= +golang.org/x/net v0.0.0-20220403103023-749bd193bc2b/go.mod h1:CfG3xpIq0wQ8r1q4Su4UZFWDARRcnwPjda9FqA0JpMk= golang.org/x/oauth2 v0.0.0-20180821212333-d2e6202438be/go.mod h1:N/0e6XlmueqKjAGxoOufVs8QHGRruUQn6yWY3a++T0U= golang.org/x/oauth2 v0.0.0-20190226205417-e64efc72b421/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= golang.org/x/oauth2 v0.0.0-20190604053449-0f29369cfe45/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= @@ -355,8 +355,8 @@ golang.org/x/sys v0.0.0-20211216021012-1d35b9e2eb4e/go.mod h1:oPkhp1MJrh7nUepCBc golang.org/x/sys v0.0.0-20220128215802-99c3d69c2c27/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.0.0-20220209214540-3681064d5158/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.0.0-20220227234510-4e6760a101f9/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.0.0-20220328115105-d36c6a25d886 h1:eJv7u3ksNXoLbGSKuv2s/SIO4tJVxc/A+MTpzxDgz/Q= -golang.org/x/sys v0.0.0-20220328115105-d36c6a25d886/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.0.0-20220403205710-6acee93ad0eb h1:PVGECzEo9Y3uOidtkHGdd347NjLtITfJFO9BxFpmRoo= +golang.org/x/sys v0.0.0-20220403205710-6acee93ad0eb/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo= golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= golang.org/x/text v0.0.0-20170915032832-14c0d48ead0c/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= @@ -536,8 +536,8 @@ google.golang.org/genproto v0.0.0-20220218161850-94dd64e39d7c/go.mod h1:kGP+zUP2 google.golang.org/genproto v0.0.0-20220222213610-43724f9ea8cf/go.mod h1:kGP+zUP2Ddo0ayMi4YuN7C3WZyJvGLZRh8Z5wnAqvEI= google.golang.org/genproto v0.0.0-20220304144024-325a89244dc8/go.mod h1:kGP+zUP2Ddo0ayMi4YuN7C3WZyJvGLZRh8Z5wnAqvEI= google.golang.org/genproto v0.0.0-20220310185008-1973136f34c6/go.mod h1:kGP+zUP2Ddo0ayMi4YuN7C3WZyJvGLZRh8Z5wnAqvEI= -google.golang.org/genproto v0.0.0-20220324131243-acbaeb5b85eb h1:0m9wktIpOxGw+SSKmydXWB3Z3GTfcPP6+q75HCQa6HI= -google.golang.org/genproto v0.0.0-20220324131243-acbaeb5b85eb/go.mod h1:hAL49I2IFola2sVEjAn7MEwsja0xp51I0tlGAf9hz4E= +google.golang.org/genproto v0.0.0-20220401170504-314d38edb7de h1:9Ti5SG2U4cAcluryUo/sFay3TQKoxiFMfaT0pbizU7k= +google.golang.org/genproto v0.0.0-20220401170504-314d38edb7de/go.mod h1:8w6bsBMX6yCPbAVTeqQHvzxW0EIFigd5lZyahWgyfDo= google.golang.org/grpc v1.19.0/go.mod h1:mqu4LbDTu4XGKhr4mRzUsmM4RtVoemTSY81AxZiDr8c= google.golang.org/grpc v1.20.1/go.mod h1:10oTOabMzJvdu6/UiuZezV6QK5dSlG84ov/aaiqXj38= google.golang.org/grpc v1.21.1/go.mod h1:oYelfM1adQP15Ek0mdvEgi9Df8B9CZIaU1084ijfRaM= @@ -580,8 +580,9 @@ google.golang.org/protobuf v1.24.0/go.mod h1:r/3tXBNzIEhYS9I1OUVjXDlt8tc493IdKGj google.golang.org/protobuf v1.25.0/go.mod h1:9JNX74DMeImyA3h4bdi1ymwjUzf21/xIlbajtzgsN7c= google.golang.org/protobuf v1.26.0-rc.1/go.mod h1:jlhhOSvTdKEhbULTjvd4ARK9grFBp09yW+WbY/TyQbw= google.golang.org/protobuf v1.26.0/go.mod h1:9q0QmTI4eRPtz6boOQmLYwt+qCgq0jsYwAQnmE0givc= -google.golang.org/protobuf v1.27.1 h1:SnqbnDw1V7RiZcXPx5MEeqPv2s79L9i7BJUlG/+RurQ= google.golang.org/protobuf v1.27.1/go.mod h1:9q0QmTI4eRPtz6boOQmLYwt+qCgq0jsYwAQnmE0givc= +google.golang.org/protobuf v1.28.0 h1:w43yiav+6bVFTBQFZX0r7ipe9JQ1QsbMgHwbBziscLw= +google.golang.org/protobuf v1.28.0/go.mod h1:HV8QOd/L58Z+nl8r43ehVNZIU/HEI6OcFqwMG9pJV4I= gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= gopkg.in/errgo.v2 v2.1.0/go.mod h1:hNsd1EY+bozCKY1Ytp96fpM3vjJbqLJn88ws8XvfDNI= From 2425be6e03d9b1fb5ccc7ee99b9a6ec776139378 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Wed, 6 Apr 2022 10:55:28 -0700 Subject: [PATCH 04/17] feat(all): auto-regenerate discovery clients (#1500) --- api-list.json | 30 --- .../v1/bigqueryreservation-api.json | 37 +--- .../v1/bigqueryreservation-gen.go | 161 -------------- .../v1/certificatemanager-api.json | 6 +- .../v1/certificatemanager-gen.go | 7 +- chromemanagement/v1/chromemanagement-api.json | 65 +++++- chromemanagement/v1/chromemanagement-gen.go | 75 ++++++- compute/v0.beta/compute-api.json | 117 +++++++++- compute/v0.beta/compute-gen.go | 201 ++++++++++++++++-- datastream/v1/datastream-api.json | 4 +- datastream/v1/datastream-gen.go | 3 +- datastream/v1alpha1/datastream-api.json | 4 +- datastream/v1alpha1/datastream-gen.go | 3 +- .../v1beta/firebasedatabase-api.json | 37 +++- .../v1beta/firebasedatabase-gen.go | 153 +++++++++++++ .../v1/networkmanagement-api.json | 4 +- networkmanagement/v1/networkmanagement-gen.go | 3 +- redis/v1beta1/redis-api.json | 4 +- redis/v1beta1/redis-gen.go | 3 +- vmmigration/v1alpha1/vmmigration-api.json | 6 +- vmmigration/v1alpha1/vmmigration-gen.go | 5 +- workflows/v1beta/workflows-api.json | 4 +- workflows/v1beta/workflows-gen.go | 3 +- 23 files changed, 642 insertions(+), 293 deletions(-) diff --git a/api-list.json b/api-list.json index 42085478027..140751ba04a 100644 --- a/api-list.json +++ b/api-list.json @@ -1984,36 +1984,6 @@ "documentationLink": "https://cloud.google.com/deployment-manager", "preferred": true }, - { - "kind": "discovery#directoryItem", - "id": "dfareporting:v3.3", - "name": "dfareporting", - "version": "v3.3", - "title": "Campaign Manager 360 API", - "description": "Build applications to efficiently manage large or complex trafficking, reporting, and attribution workflows for Campaign Manager 360.", - "discoveryRestUrl": "https://dfareporting.googleapis.com/$discovery/rest?version=v3.3", - "icons": { - "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", - "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" - }, - "documentationLink": "https://developers.google.com/doubleclick-advertisers/", - "preferred": false - }, - { - "kind": "discovery#directoryItem", - "id": "dfareporting:v3.4", - "name": "dfareporting", - "version": "v3.4", - "title": "Campaign Manager 360 API", - "description": "Build applications to efficiently manage large or complex trafficking, reporting, and attribution workflows for Campaign Manager 360.", - "discoveryRestUrl": "https://dfareporting.googleapis.com/$discovery/rest?version=v3.4", - "icons": { - "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", - "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" - }, - "documentationLink": "https://developers.google.com/doubleclick-advertisers/", - "preferred": false - }, { "kind": "discovery#directoryItem", "id": "dfareporting:v3.5", diff --git a/bigqueryreservation/v1/bigqueryreservation-api.json b/bigqueryreservation/v1/bigqueryreservation-api.json index ef0c49286b9..425fa5fb671 100644 --- a/bigqueryreservation/v1/bigqueryreservation-api.json +++ b/bigqueryreservation/v1/bigqueryreservation-api.json @@ -778,41 +778,6 @@ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] - }, - "patch": { - "description": "Updates an existing assignment. Only the `priority` field can be updated.", - "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/reservations/{reservationsId}/assignments/{assignmentsId}", - "httpMethod": "PATCH", - "id": "bigqueryreservation.projects.locations.reservations.assignments.patch", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Output only. Name of the resource. E.g.: `projects/myproject/locations/US/reservations/team1-prod/assignments/123`. For the assignment id, it must only contain lower case alphanumeric characters or dashes and the max length is 64 characters.", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/reservations/[^/]+/assignments/[^/]+$", - "required": true, - "type": "string" - }, - "updateMask": { - "description": "Standard field mask for the set of fields to be updated.", - "format": "google-fieldmask", - "location": "query", - "type": "string" - } - }, - "path": "v1/{+name}", - "request": { - "$ref": "Assignment" - }, - "response": { - "$ref": "Assignment" - }, - "scopes": [ - "https://www.googleapis.com/auth/bigquery", - "https://www.googleapis.com/auth/cloud-platform" - ] } } } @@ -823,7 +788,7 @@ } } }, - "revision": "20220326", + "revision": "20220331", "rootUrl": "https://bigqueryreservation.googleapis.com/", "schemas": { "Assignment": { diff --git a/bigqueryreservation/v1/bigqueryreservation-gen.go b/bigqueryreservation/v1/bigqueryreservation-gen.go index 000f067b982..4cf7405ba37 100644 --- a/bigqueryreservation/v1/bigqueryreservation-gen.go +++ b/bigqueryreservation/v1/bigqueryreservation-gen.go @@ -4236,164 +4236,3 @@ func (c *ProjectsLocationsReservationsAssignmentsMoveCall) Do(opts ...googleapi. // } } - -// method id "bigqueryreservation.projects.locations.reservations.assignments.patch": - -type ProjectsLocationsReservationsAssignmentsPatchCall struct { - s *Service - name string - assignment *Assignment - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Patch: Updates an existing assignment. Only the `priority` field can -// be updated. -// -// - name: Output only. Name of the resource. E.g.: -// `projects/myproject/locations/US/reservations/team1-prod/assignments -// /123`. For the assignment id, it must only contain lower case -// alphanumeric characters or dashes and the max length is 64 -// characters. -func (r *ProjectsLocationsReservationsAssignmentsService) Patch(name string, assignment *Assignment) *ProjectsLocationsReservationsAssignmentsPatchCall { - c := &ProjectsLocationsReservationsAssignmentsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.assignment = assignment - return c -} - -// UpdateMask sets the optional parameter "updateMask": Standard field -// mask for the set of fields to be updated. -func (c *ProjectsLocationsReservationsAssignmentsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsReservationsAssignmentsPatchCall { - c.urlParams_.Set("updateMask", updateMask) - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse -// for more information. -func (c *ProjectsLocationsReservationsAssignmentsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsReservationsAssignmentsPatchCall { - 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 *ProjectsLocationsReservationsAssignmentsPatchCall) Context(ctx context.Context) *ProjectsLocationsReservationsAssignmentsPatchCall { - 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 *ProjectsLocationsReservationsAssignmentsPatchCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsReservationsAssignmentsPatchCall) 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.assignment) - if err != nil { - return nil, err - } - reqHeaders.Set("Content-Type", "application/json") - c.urlParams_.Set("alt", alt) - c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "name": c.name, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "bigqueryreservation.projects.locations.reservations.assignments.patch" call. -// Exactly one of *Assignment or error will be non-nil. Any non-2xx -// status code is an error. Response headers are in either -// *Assignment.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 *ProjectsLocationsReservationsAssignmentsPatchCall) Do(opts ...googleapi.CallOption) (*Assignment, 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 := &Assignment{ - 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 an existing assignment. Only the `priority` field can be updated.", - // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/reservations/{reservationsId}/assignments/{assignmentsId}", - // "httpMethod": "PATCH", - // "id": "bigqueryreservation.projects.locations.reservations.assignments.patch", - // "parameterOrder": [ - // "name" - // ], - // "parameters": { - // "name": { - // "description": "Output only. Name of the resource. E.g.: `projects/myproject/locations/US/reservations/team1-prod/assignments/123`. For the assignment id, it must only contain lower case alphanumeric characters or dashes and the max length is 64 characters.", - // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/reservations/[^/]+/assignments/[^/]+$", - // "required": true, - // "type": "string" - // }, - // "updateMask": { - // "description": "Standard field mask for the set of fields to be updated.", - // "format": "google-fieldmask", - // "location": "query", - // "type": "string" - // } - // }, - // "path": "v1/{+name}", - // "request": { - // "$ref": "Assignment" - // }, - // "response": { - // "$ref": "Assignment" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/bigquery", - // "https://www.googleapis.com/auth/cloud-platform" - // ] - // } - -} diff --git a/certificatemanager/v1/certificatemanager-api.json b/certificatemanager/v1/certificatemanager-api.json index 0466b96be71..6503126d102 100644 --- a/certificatemanager/v1/certificatemanager-api.json +++ b/certificatemanager/v1/certificatemanager-api.json @@ -975,7 +975,7 @@ } } }, - "revision": "20220223", + "revision": "20220324", "rootUrl": "https://certificatemanager.googleapis.com/", "schemas": { "AuthorizationAttemptInfo": { @@ -1073,7 +1073,7 @@ "type": "string" }, "sanDnsnames": { - "description": "Output only. The list of Subject Alternative Names of dnsName type defined in the certificate (see RFC 5280 4.2.1.6)", + "description": "Output only. The list of Subject Alternative Names of dnsName type defined in the certificate (see RFC 5280 4.2.1.6). Managed certificates that haven't been provisioned yet have this field populated with a value of the managed.domains field.", "items": { "type": "string" }, @@ -1285,7 +1285,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/certificatemanager/v1/certificatemanager-gen.go b/certificatemanager/v1/certificatemanager-gen.go index 1d38c1ebeaa..431c2543e33 100644 --- a/certificatemanager/v1/certificatemanager-gen.go +++ b/certificatemanager/v1/certificatemanager-gen.go @@ -311,7 +311,9 @@ type Certificate struct { PemCertificate string `json:"pemCertificate,omitempty"` // SanDnsnames: Output only. The list of Subject Alternative Names of - // dnsName type defined in the certificate (see RFC 5280 4.2.1.6) + // dnsName type defined in the certificate (see RFC 5280 4.2.1.6). + // Managed certificates that haven't been provisioned yet have this + // field populated with a value of the managed.domains field. SanDnsnames []string `json:"sanDnsnames,omitempty"` // Scope: Immutable. The scope of the certificate. @@ -589,8 +591,7 @@ func (s *DnsResourceRecord) 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. diff --git a/chromemanagement/v1/chromemanagement-api.json b/chromemanagement/v1/chromemanagement-api.json index 9029a5571ff..54a98ba4d7d 100644 --- a/chromemanagement/v1/chromemanagement-api.json +++ b/chromemanagement/v1/chromemanagement-api.json @@ -488,7 +488,7 @@ } } }, - "revision": "20220326", + "revision": "20220331", "rootUrl": "https://chromemanagement.googleapis.com/", "schemas": { "GoogleChromeManagementV1AndroidAppInfo": { @@ -636,6 +636,51 @@ }, "type": "object" }, + "GoogleChromeManagementV1AudioStatusReport": { + "description": "Audio report.", + "id": "GoogleChromeManagementV1AudioStatusReport", + "properties": { + "inputDevice": { + "description": "Output only. Active input device's name.", + "readOnly": true, + "type": "string" + }, + "inputGain": { + "description": "Output only. Active input device's gain in [0, 100].", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "inputMute": { + "description": "Output only. Is active input device mute or not.", + "readOnly": true, + "type": "boolean" + }, + "outputDevice": { + "description": "Output only. Active output device's name.", + "readOnly": true, + "type": "string" + }, + "outputMute": { + "description": "Output only. Is active output device mute or not.", + "readOnly": true, + "type": "boolean" + }, + "outputVolume": { + "description": "Output only. Active output device's volume in [0, 100].", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "reportTime": { + "description": "Output only. Timestamp of when the sample was collected on device.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "GoogleChromeManagementV1BatteryInfo": { "description": "Battery info", "id": "GoogleChromeManagementV1BatteryInfo", @@ -865,11 +910,21 @@ "readOnly": true, "type": "boolean" }, + "isKioskOnly": { + "description": "Output only. Whether the app is only for Kiosk mode on Chrome OS devices", + "readOnly": true, + "type": "boolean" + }, "isTheme": { "description": "Output only. Whether the app or extension is a theme.", "readOnly": true, "type": "boolean" }, + "kioskEnabled": { + "description": "Output only. Whether this app is enabled for Kiosk mode on Chrome OS devices", + "readOnly": true, + "type": "boolean" + }, "minUserCount": { "description": "Output only. The minimum number of users using this app.", "format": "int32", @@ -1678,6 +1733,14 @@ "description": "Telemetry data collected from a managed device.", "id": "GoogleChromeManagementV1TelemetryDevice", "properties": { + "audioStatusReport": { + "description": "Output only. Audio reports collected periodically.", + "items": { + "$ref": "GoogleChromeManagementV1AudioStatusReport" + }, + "readOnly": true, + "type": "array" + }, "batteryInfo": { "description": "Output only. Information on battery specs for the device.", "items": { diff --git a/chromemanagement/v1/chromemanagement-gen.go b/chromemanagement/v1/chromemanagement-gen.go index e89838c8ef8..d7cdafbd842 100644 --- a/chromemanagement/v1/chromemanagement-gen.go +++ b/chromemanagement/v1/chromemanagement-gen.go @@ -424,6 +424,53 @@ func (s *GoogleChromeManagementV1AppDetails) UnmarshalJSON(data []byte) error { return nil } +// GoogleChromeManagementV1AudioStatusReport: Audio report. +type GoogleChromeManagementV1AudioStatusReport struct { + // InputDevice: Output only. Active input device's name. + InputDevice string `json:"inputDevice,omitempty"` + + // InputGain: Output only. Active input device's gain in [0, 100]. + InputGain int64 `json:"inputGain,omitempty"` + + // InputMute: Output only. Is active input device mute or not. + InputMute bool `json:"inputMute,omitempty"` + + // OutputDevice: Output only. Active output device's name. + OutputDevice string `json:"outputDevice,omitempty"` + + // OutputMute: Output only. Is active output device mute or not. + OutputMute bool `json:"outputMute,omitempty"` + + // OutputVolume: Output only. Active output device's volume in [0, 100]. + OutputVolume int64 `json:"outputVolume,omitempty"` + + // ReportTime: Output only. Timestamp of when the sample was collected + // on device. + ReportTime string `json:"reportTime,omitempty"` + + // ForceSendFields is a list of field names (e.g. "InputDevice") 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. "InputDevice") 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 *GoogleChromeManagementV1AudioStatusReport) MarshalJSON() ([]byte, error) { + type NoMethod GoogleChromeManagementV1AudioStatusReport + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleChromeManagementV1BatteryInfo: Battery info type GoogleChromeManagementV1BatteryInfo struct { // DesignCapacity: Output only. Design capacity (mAmpere-hours). @@ -647,9 +694,17 @@ type GoogleChromeManagementV1ChromeAppInfo struct { // published state in the Chrome Web Store. IsCwsHosted bool `json:"isCwsHosted,omitempty"` + // IsKioskOnly: Output only. Whether the app is only for Kiosk mode on + // Chrome OS devices + IsKioskOnly bool `json:"isKioskOnly,omitempty"` + // IsTheme: Output only. Whether the app or extension is a theme. IsTheme bool `json:"isTheme,omitempty"` + // KioskEnabled: Output only. Whether this app is enabled for Kiosk mode + // on Chrome OS devices + KioskEnabled bool `json:"kioskEnabled,omitempty"` + // MinUserCount: Output only. The minimum number of users using this // app. MinUserCount int64 `json:"minUserCount,omitempty"` @@ -1735,6 +1790,9 @@ func (s *GoogleChromeManagementV1StorageStatusReport) MarshalJSON() ([]byte, err // GoogleChromeManagementV1TelemetryDevice: Telemetry data collected // from a managed device. type GoogleChromeManagementV1TelemetryDevice struct { + // AudioStatusReport: Output only. Audio reports collected periodically. + AudioStatusReport []*GoogleChromeManagementV1AudioStatusReport `json:"audioStatusReport,omitempty"` + // BatteryInfo: Output only. Information on battery specs for the // device. BatteryInfo []*GoogleChromeManagementV1BatteryInfo `json:"batteryInfo,omitempty"` @@ -1802,20 +1860,21 @@ type GoogleChromeManagementV1TelemetryDevice struct { // periodically. StorageStatusReport []*GoogleChromeManagementV1StorageStatusReport `json:"storageStatusReport,omitempty"` - // ForceSendFields is a list of field names (e.g. "BatteryInfo") to - // unconditionally include in API requests. By default, fields with + // ForceSendFields is a list of field names (e.g. "AudioStatusReport") + // 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. "BatteryInfo") 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 is a list of field names (e.g. "AudioStatusReport") 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:"-"` } diff --git a/compute/v0.beta/compute-api.json b/compute/v0.beta/compute-api.json index b0f63c3200f..bac31984072 100644 --- a/compute/v0.beta/compute-api.json +++ b/compute/v0.beta/compute-api.json @@ -34792,7 +34792,7 @@ } } }, - "revision": "20220315", + "revision": "20220322", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -35773,6 +35773,11 @@ "description": "The number of threads per physical core. To disable simultaneous multithreading (SMT) set this to 1. If unset, the maximum number of threads supported per core by the underlying processor is assumed.", "format": "int32", "type": "integer" + }, + "visibleCoreCount": { + "description": "The number of physical cores to expose to an instance. Multiply by the number of threads per core to compute the total number of virtual CPUs to expose to the instance. If unset, the number of cores is inferred from the instance's nominal CPU count and the underlying platform's SMT width.", + "format": "int32", + "type": "integer" } }, "type": "object" @@ -37382,6 +37387,13 @@ ], "type": "string" }, + "localityLbPolicies": { + "description": "A list of locality load balancing policies to be used in order of preference. Either the policy or the customPolicy field should be set. Overrides any value set in the localityLbPolicy field. localityLbPolicies is only supported when the BackendService is referenced by a URL Map that is referenced by a target gRPC proxy that has the validateForProxyless field set to true.", + "items": { + "$ref": "BackendServiceLocalityLoadBalancingPolicyConfig" + }, + "type": "array" + }, "localityLbPolicy": { "description": "The load balancing algorithm used within the scope of the locality. The possible values are: - ROUND_ROBIN: This is a simple policy in which each healthy backend is selected in round robin order. This is the default. - LEAST_REQUEST: An O(1) algorithm which selects two random healthy hosts and picks the host which has fewer active requests. - RING_HASH: The ring/modulo hash load balancer implements consistent hashing to backends. The algorithm has the property that the addition/removal of a host from a set of N hosts only affects 1/N of the requests. - RANDOM: The load balancer selects a random healthy host. - ORIGINAL_DESTINATION: Backend host is selected based on the client connection metadata, i.e., connections are opened to the same address as the destination address of the incoming connection before the connection was redirected to the load balancer. - MAGLEV: used as a drop in replacement for the ring hash load balancer. Maglev is not as stable as ring hash but has faster table lookup build times and host selection times. For more information about Maglev, see https://ai.google/research/pubs/pub44824 This field is applicable to either: - A regional backend service with the service_protocol set to HTTP, HTTPS, or HTTP2, and load_balancing_scheme set to INTERNAL_MANAGED. - A global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED. If sessionAffinity is not NONE, and this field is not set to MAGLEV or RING_HASH, session affinity settings will not take effect. Only ROUND_ROBIN and RING_HASH are supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true.", "enum": [ @@ -37979,6 +37991,65 @@ }, "type": "object" }, + "BackendServiceLocalityLoadBalancingPolicyConfig": { + "description": "Container for either a built-in LB policy supported by gRPC or Envoy or a custom one implemented by the end user.", + "id": "BackendServiceLocalityLoadBalancingPolicyConfig", + "properties": { + "customPolicy": { + "$ref": "BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy" + }, + "policy": { + "$ref": "BackendServiceLocalityLoadBalancingPolicyConfigPolicy" + } + }, + "type": "object" + }, + "BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy": { + "description": "The configuration for a custom policy implemented by the user and deployed with the client.", + "id": "BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy", + "properties": { + "data": { + "description": "An optional, arbitrary JSON object with configuration data, understood by a locally installed custom policy implementation.", + "type": "string" + }, + "name": { + "description": "Identifies the custom policy. The value should match the type the custom implementation is registered with on the gRPC clients. It should follow protocol buffer message naming conventions and include the full path (e.g. myorg.CustomLbPolicy). The maximum length is 256 characters. Note that specifying the same custom policy more than once for a backend is not a valid configuration and will be rejected.", + "type": "string" + } + }, + "type": "object" + }, + "BackendServiceLocalityLoadBalancingPolicyConfigPolicy": { + "description": "The configuration for a built-in load balancing policy.", + "id": "BackendServiceLocalityLoadBalancingPolicyConfigPolicy", + "properties": { + "name": { + "description": "The name of a locality load balancer policy to be used. The value should be one of the predefined ones as supported by localityLbPolicy, although at the moment only ROUND_ROBIN is supported. This field should only be populated when the customPolicy field is not used. Note that specifying the same policy more than once for a backend is not a valid configuration and will be rejected.", + "enum": [ + "INVALID_LB_POLICY", + "LEAST_REQUEST", + "MAGLEV", + "ORIGINAL_DESTINATION", + "RANDOM", + "RING_HASH", + "ROUND_ROBIN", + "WEIGHTED_MAGLEV" + ], + "enumDescriptions": [ + "", + "An O(1) algorithm which selects two random healthy hosts and picks the host which has fewer active requests.", + "This algorithm implements consistent hashing to backends. Maglev can be used as a drop in replacement for the ring hash load balancer. Maglev is not as stable as ring hash but has faster table lookup build times and host selection times. For more information about Maglev, see https://ai.google/research/pubs/pub44824", + "Backend host is selected based on the client connection metadata, i.e., connections are opened to the same address as the destination address of the incoming connection before the connection was redirected to the load balancer.", + "The load balancer selects a random healthy host.", + "The ring/modulo hash load balancer implements consistent hashing to backends. The algorithm has the property that the addition/removal of a host from a set of N hosts only affects 1/N of the requests.", + "This is a simple policy in which each healthy backend is selected in round robin order. This is the default.", + "Per-instance weighted Load Balancing via health check reported weights. If set, the Backend Service must configure a non legacy HTTP-based Health Check, and health check replies are expected to contain non-standard HTTP response header field X-Load-Balancing-Endpoint-Weight to specify the per-instance weights. If set, Load Balancing is weighted based on the per-instance weights reported in the last processed health check replies, as long as every instance either reported a valid weight or had UNAVAILABLE_WEIGHT. Otherwise, Load Balancing remains equal-weight. This option is only supported in Network Load Balancing." + ], + "type": "string" + } + }, + "type": "object" + }, "BackendServiceLogConfig": { "description": "The available logging options for the load balancer traffic served by this backend service.", "id": "BackendServiceLogConfig", @@ -41396,6 +41467,10 @@ "format": "int32", "type": "integer" }, + "ruleName": { + "description": "An optional name for the rule. This field is not a unique identifier and can be updated.", + "type": "string" + }, "ruleTupleCount": { "description": "[Output Only] Calculation of the complexity of a single firewall policy rule.", "format": "int32", @@ -41436,6 +41511,20 @@ }, "type": "array" }, + "destRegionCodes": { + "description": "Region codes whose IP addresses will be used to match for destination of traffic. Should be specified as 2 letter country code defined as per ISO 3166 alpha-2 country codes. ex.\"US\" Maximum number of dest region codes allowed is 5000.", + "items": { + "type": "string" + }, + "type": "array" + }, + "destThreatIntelligences": { + "description": "Names of Network Threat Intelligence lists. The IPs in these lists will be matched against traffic destination.", + "items": { + "type": "string" + }, + "type": "array" + }, "layer4Configs": { "description": "Pairs of IP protocols and ports that the rule should match.", "items": { @@ -41450,12 +41539,26 @@ }, "type": "array" }, + "srcRegionCodes": { + "description": "Region codes whose IP addresses will be used to match for source of traffic. Should be specified as 2 letter country code defined as per ISO 3166 alpha-2 country codes. ex.\"US\" Maximum number of source region codes allowed is 5000.", + "items": { + "type": "string" + }, + "type": "array" + }, "srcSecureTags": { "description": "List of secure tag values, which should be matched at the source of the traffic. For INGRESS rule, if all the srcSecureTag are INEFFECTIVE, and there is no srcIpRange, this rule will be ignored. Maximum number of source tag values allowed is 256.", "items": { "$ref": "FirewallPolicyRuleSecureTag" }, "type": "array" + }, + "srcThreatIntelligences": { + "description": "Names of Network Threat Intelligence lists. The IPs in these lists will be matched against traffic source.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -63749,7 +63852,7 @@ "type": "boolean" }, "externalIpv6Prefix": { - "description": "[Output Only] The range of external IPv6 addresses that are owned by this subnetwork.", + "description": "[Output Only] The external IPv6 address range that is assigned to this subnetwork.", "type": "string" }, "fingerprint": { @@ -63767,7 +63870,7 @@ "type": "string" }, "internalIpv6Prefix": { - "description": "[Output Only] The range of internal IPv6 addresses that are owned by this subnetwork. Note this is for general VM to VM communication, not to be confused with the ipv6_cidr_range field.", + "description": "[Output Only] The internal IPv6 address range that is assigned to this subnetwork.", "type": "string" }, "ipCidrRange": { @@ -63775,19 +63878,19 @@ "type": "string" }, "ipv6AccessType": { - "description": "The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack. If the ipv6_type is EXTERNAL then this subnet cannot enable direct path.", + "description": "The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack.", "enum": [ "EXTERNAL", "INTERNAL" ], "enumDescriptions": [ - "VMs on this subnet will be assigned IPv6 addresses that are accesible via the Internet, as well as the VPC network.", + "VMs on this subnet will be assigned IPv6 addresses that are accessible via the Internet, as well as the VPC network.", "VMs on this subnet will be assigned IPv6 addresses that are only accessible over the VPC network." ], "type": "string" }, "ipv6CidrRange": { - "description": "[Output Only] The range of internal IPv6 addresses that are owned by this subnetwork. Note this will be for private google access only eventually.", + "description": "[Output Only] This field is for internal use.", "type": "string" }, "kind": { @@ -63813,7 +63916,7 @@ "type": "boolean" }, "privateIpv6GoogleAccess": { - "description": "The private IPv6 google access type for the VMs in this subnet. This is an expanded field of enablePrivateV6Access. If both fields are set, privateIpv6GoogleAccess will take priority. This field can be both set at resource creation time and updated using patch.", + "description": "This field is for internal use. This field can be both set at resource creation time and updated using patch.", "enum": [ "DISABLE_GOOGLE_ACCESS", "ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE", diff --git a/compute/v0.beta/compute-gen.go b/compute/v0.beta/compute-gen.go index c6708a2ad17..a64fbb79479 100644 --- a/compute/v0.beta/compute-gen.go +++ b/compute/v0.beta/compute-gen.go @@ -2699,6 +2699,13 @@ type AdvancedMachineFeatures struct { // processor is assumed. ThreadsPerCore int64 `json:"threadsPerCore,omitempty"` + // VisibleCoreCount: The number of physical cores to expose to an + // instance. Multiply by the number of threads per core to compute the + // total number of virtual CPUs to expose to the instance. If unset, the + // number of cores is inferred from the instance's nominal CPU count and + // the underlying platform's SMT width. + VisibleCoreCount int64 `json:"visibleCoreCount,omitempty"` + // ForceSendFields is a list of field names (e.g. // "EnableNestedVirtualization") to unconditionally include in API // requests. By default, fields with empty or default values are omitted @@ -5379,6 +5386,14 @@ type BackendService struct { // "INVALID_LOAD_BALANCING_SCHEME" LoadBalancingScheme string `json:"loadBalancingScheme,omitempty"` + // LocalityLbPolicies: A list of locality load balancing policies to be + // used in order of preference. Either the policy or the customPolicy + // field should be set. Overrides any value set in the localityLbPolicy + // field. localityLbPolicies is only supported when the BackendService + // is referenced by a URL Map that is referenced by a target gRPC proxy + // that has the validateForProxyless field set to true. + LocalityLbPolicies []*BackendServiceLocalityLoadBalancingPolicyConfig `json:"localityLbPolicies,omitempty"` + // LocalityLbPolicy: The load balancing algorithm used within the scope // of the locality. The possible values are: - ROUND_ROBIN: This is a // simple policy in which each healthy backend is selected in round @@ -6467,6 +6482,142 @@ func (s *BackendServiceListWarningData) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// BackendServiceLocalityLoadBalancingPolicyConfig: Container for either +// a built-in LB policy supported by gRPC or Envoy or a custom one +// implemented by the end user. +type BackendServiceLocalityLoadBalancingPolicyConfig struct { + CustomPolicy *BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy `json:"customPolicy,omitempty"` + + Policy *BackendServiceLocalityLoadBalancingPolicyConfigPolicy `json:"policy,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CustomPolicy") 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. "CustomPolicy") 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 *BackendServiceLocalityLoadBalancingPolicyConfig) MarshalJSON() ([]byte, error) { + type NoMethod BackendServiceLocalityLoadBalancingPolicyConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy: The +// configuration for a custom policy implemented by the user and +// deployed with the client. +type BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy struct { + // Data: An optional, arbitrary JSON object with configuration data, + // understood by a locally installed custom policy implementation. + Data string `json:"data,omitempty"` + + // Name: Identifies the custom policy. The value should match the type + // the custom implementation is registered with on the gRPC clients. It + // should follow protocol buffer message naming conventions and include + // the full path (e.g. myorg.CustomLbPolicy). The maximum length is 256 + // characters. Note that specifying the same custom policy more than + // once for a backend is not a valid configuration and will be rejected. + Name string `json:"name,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Data") 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. "Data") 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 *BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy) MarshalJSON() ([]byte, error) { + type NoMethod BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BackendServiceLocalityLoadBalancingPolicyConfigPolicy: The +// configuration for a built-in load balancing policy. +type BackendServiceLocalityLoadBalancingPolicyConfigPolicy struct { + // Name: The name of a locality load balancer policy to be used. The + // value should be one of the predefined ones as supported by + // localityLbPolicy, although at the moment only ROUND_ROBIN is + // supported. This field should only be populated when the customPolicy + // field is not used. Note that specifying the same policy more than + // once for a backend is not a valid configuration and will be rejected. + // + // Possible values: + // "INVALID_LB_POLICY" + // "LEAST_REQUEST" - An O(1) algorithm which selects two random + // healthy hosts and picks the host which has fewer active requests. + // "MAGLEV" - This algorithm implements consistent hashing to + // backends. Maglev can be used as a drop in replacement for the ring + // hash load balancer. Maglev is not as stable as ring hash but has + // faster table lookup build times and host selection times. For more + // information about Maglev, see + // https://ai.google/research/pubs/pub44824 + // "ORIGINAL_DESTINATION" - Backend host is selected based on the + // client connection metadata, i.e., connections are opened to the same + // address as the destination address of the incoming connection before + // the connection was redirected to the load balancer. + // "RANDOM" - The load balancer selects a random healthy host. + // "RING_HASH" - The ring/modulo hash load balancer implements + // consistent hashing to backends. The algorithm has the property that + // the addition/removal of a host from a set of N hosts only affects 1/N + // of the requests. + // "ROUND_ROBIN" - This is a simple policy in which each healthy + // backend is selected in round robin order. This is the default. + // "WEIGHTED_MAGLEV" - Per-instance weighted Load Balancing via health + // check reported weights. If set, the Backend Service must configure a + // non legacy HTTP-based Health Check, and health check replies are + // expected to contain non-standard HTTP response header field + // X-Load-Balancing-Endpoint-Weight to specify the per-instance weights. + // If set, Load Balancing is weighted based on the per-instance weights + // reported in the last processed health check replies, as long as every + // instance either reported a valid weight or had UNAVAILABLE_WEIGHT. + // Otherwise, Load Balancing remains equal-weight. This option is only + // supported in Network Load Balancing. + Name string `json:"name,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Name") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. 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. "Name") 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 *BackendServiceLocalityLoadBalancingPolicyConfigPolicy) MarshalJSON() ([]byte, error) { + type NoMethod BackendServiceLocalityLoadBalancingPolicyConfigPolicy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // BackendServiceLogConfig: The available logging options for the load // balancer traffic served by this backend service. type BackendServiceLogConfig struct { @@ -11798,6 +11949,10 @@ type FirewallPolicyRule struct { // priority and 2147483647 is the lowest prority. Priority int64 `json:"priority,omitempty"` + // RuleName: An optional name for the rule. This field is not a unique + // identifier and can be updated. + RuleName string `json:"ruleName,omitempty"` + // RuleTupleCount: [Output Only] Calculation of the complexity of a // single firewall policy rule. RuleTupleCount int64 `json:"ruleTupleCount,omitempty"` @@ -11858,6 +12013,16 @@ type FirewallPolicyRuleMatcher struct { // CIDR IP ranges allowed is 5000. DestIpRanges []string `json:"destIpRanges,omitempty"` + // DestRegionCodes: Region codes whose IP addresses will be used to + // match for destination of traffic. Should be specified as 2 letter + // country code defined as per ISO 3166 alpha-2 country codes. ex."US" + // Maximum number of dest region codes allowed is 5000. + DestRegionCodes []string `json:"destRegionCodes,omitempty"` + + // DestThreatIntelligences: Names of Network Threat Intelligence lists. + // The IPs in these lists will be matched against traffic destination. + DestThreatIntelligences []string `json:"destThreatIntelligences,omitempty"` + // Layer4Configs: Pairs of IP protocols and ports that the rule should // match. Layer4Configs []*FirewallPolicyRuleMatcherLayer4Config `json:"layer4Configs,omitempty"` @@ -11866,12 +12031,22 @@ type FirewallPolicyRuleMatcher struct { // ranges allowed is 5000. SrcIpRanges []string `json:"srcIpRanges,omitempty"` + // SrcRegionCodes: Region codes whose IP addresses will be used to match + // for source of traffic. Should be specified as 2 letter country code + // defined as per ISO 3166 alpha-2 country codes. ex."US" Maximum number + // of source region codes allowed is 5000. + SrcRegionCodes []string `json:"srcRegionCodes,omitempty"` + // SrcSecureTags: List of secure tag values, which should be matched at // the source of the traffic. For INGRESS rule, if all the srcSecureTag // are INEFFECTIVE, and there is no srcIpRange, this rule will be // ignored. Maximum number of source tag values allowed is 256. SrcSecureTags []*FirewallPolicyRuleSecureTag `json:"srcSecureTags,omitempty"` + // SrcThreatIntelligences: Names of Network Threat Intelligence lists. + // The IPs in these lists will be matched against traffic source. + SrcThreatIntelligences []string `json:"srcThreatIntelligences,omitempty"` + // ForceSendFields is a list of field names (e.g. "DestIpRanges") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -46743,8 +46918,8 @@ type Subnetwork struct { // INTERNAL_HTTPS_LOAD_BALANCER. EnableFlowLogs bool `json:"enableFlowLogs,omitempty"` - // ExternalIpv6Prefix: [Output Only] The range of external IPv6 - // addresses that are owned by this subnetwork. + // ExternalIpv6Prefix: [Output Only] The external IPv6 address range + // that is assigned to this subnetwork. ExternalIpv6Prefix string `json:"externalIpv6Prefix,omitempty"` // Fingerprint: Fingerprint of this resource. A hash of the contents @@ -46764,10 +46939,8 @@ type Subnetwork struct { // identifier is defined by the server. Id uint64 `json:"id,omitempty,string"` - // InternalIpv6Prefix: [Output Only] The range of internal IPv6 - // addresses that are owned by this subnetwork. Note this is for general - // VM to VM communication, not to be confused with the ipv6_cidr_range - // field. + // InternalIpv6Prefix: [Output Only] The internal IPv6 address range + // that is assigned to this subnetwork. InternalIpv6Prefix string `json:"internalIpv6Prefix,omitempty"` // IpCidrRange: The range of internal addresses that are owned by this @@ -46781,19 +46954,16 @@ type Subnetwork struct { // Ipv6AccessType: The access type of IPv6 address this subnet holds. // It's immutable and can only be specified during creation or the first - // time the subnet is updated into IPV4_IPV6 dual stack. If the - // ipv6_type is EXTERNAL then this subnet cannot enable direct path. + // time the subnet is updated into IPV4_IPV6 dual stack. // // Possible values: // "EXTERNAL" - VMs on this subnet will be assigned IPv6 addresses - // that are accesible via the Internet, as well as the VPC network. + // that are accessible via the Internet, as well as the VPC network. // "INTERNAL" - VMs on this subnet will be assigned IPv6 addresses // that are only accessible over the VPC network. Ipv6AccessType string `json:"ipv6AccessType,omitempty"` - // Ipv6CidrRange: [Output Only] The range of internal IPv6 addresses - // that are owned by this subnetwork. Note this will be for private - // google access only eventually. + // Ipv6CidrRange: [Output Only] This field is for internal use. Ipv6CidrRange string `json:"ipv6CidrRange,omitempty"` // Kind: [Output Only] Type of the resource. Always compute#subnetwork @@ -46825,11 +46995,8 @@ type Subnetwork struct { // setPrivateIpGoogleAccess. PrivateIpGoogleAccess bool `json:"privateIpGoogleAccess,omitempty"` - // PrivateIpv6GoogleAccess: The private IPv6 google access type for the - // VMs in this subnet. This is an expanded field of - // enablePrivateV6Access. If both fields are set, - // privateIpv6GoogleAccess will take priority. This field can be both - // set at resource creation time and updated using patch. + // PrivateIpv6GoogleAccess: This field is for internal use. This field + // can be both set at resource creation time and updated using patch. // // Possible values: // "DISABLE_GOOGLE_ACCESS" - Disable private IPv6 access to/from diff --git a/datastream/v1/datastream-api.json b/datastream/v1/datastream-api.json index eb1b95b1239..5c3c6d83938 100644 --- a/datastream/v1/datastream-api.json +++ b/datastream/v1/datastream-api.json @@ -1217,7 +1217,7 @@ } } }, - "revision": "20220316", + "revision": "20220322", "rootUrl": "https://datastream.googleapis.com/", "schemas": { "AvroFileFormat": { @@ -1440,7 +1440,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/datastream/v1/datastream-gen.go b/datastream/v1/datastream-gen.go index f14974ee72a..ed2f9bc91ee 100644 --- a/datastream/v1/datastream-gen.go +++ b/datastream/v1/datastream-gen.go @@ -527,8 +527,7 @@ func (s *DiscoverConnectionProfileResponse) 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. diff --git a/datastream/v1alpha1/datastream-api.json b/datastream/v1alpha1/datastream-api.json index 83cd1e9c100..509e171bcb1 100644 --- a/datastream/v1alpha1/datastream-api.json +++ b/datastream/v1alpha1/datastream-api.json @@ -1196,7 +1196,7 @@ } } }, - "revision": "20220316", + "revision": "20220322", "rootUrl": "https://datastream.googleapis.com/", "schemas": { "AvroFileFormat": { @@ -1421,7 +1421,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/datastream/v1alpha1/datastream-gen.go b/datastream/v1alpha1/datastream-gen.go index 77efe2f43d2..75b32c65ace 100644 --- a/datastream/v1alpha1/datastream-gen.go +++ b/datastream/v1alpha1/datastream-gen.go @@ -525,8 +525,7 @@ func (s *DiscoverConnectionProfileResponse) 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. diff --git a/firebasedatabase/v1beta/firebasedatabase-api.json b/firebasedatabase/v1beta/firebasedatabase-api.json index df33a09b34b..e0da6fcaa4e 100644 --- a/firebasedatabase/v1beta/firebasedatabase-api.json +++ b/firebasedatabase/v1beta/firebasedatabase-api.json @@ -314,6 +314,35 @@ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/firebase" ] + }, + "undelete": { + "description": "Restores a DatabaseInstance that was previously marked to be deleted. This may only be used on a DatabaseInstance in the DELETED state. Purged DatabaseInstance's may not be recovered.", + "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:undelete", + "httpMethod": "POST", + "id": "firebasedatabase.projects.locations.instances.undelete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The fully qualified resource name of the database instance, in the form: `projects/{project-number}/locations/{location-id}/instances/{database-id}`", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+name}:undelete", + "request": { + "$ref": "UndeleteDatabaseInstanceRequest" + }, + "response": { + "$ref": "DatabaseInstance" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/firebase" + ] } } } @@ -322,7 +351,7 @@ } } }, - "revision": "20220328", + "revision": "20220330", "rootUrl": "https://firebasedatabase.googleapis.com/", "schemas": { "DatabaseInstance": { @@ -403,6 +432,12 @@ "id": "ReenableDatabaseInstanceRequest", "properties": {}, "type": "object" + }, + "UndeleteDatabaseInstanceRequest": { + "description": "The request sent to UndeleteDatabaseInstance method.", + "id": "UndeleteDatabaseInstanceRequest", + "properties": {}, + "type": "object" } }, "servicePath": "", diff --git a/firebasedatabase/v1beta/firebasedatabase-gen.go b/firebasedatabase/v1beta/firebasedatabase-gen.go index 35f7ee2a51c..e81c5feb335 100644 --- a/firebasedatabase/v1beta/firebasedatabase-gen.go +++ b/firebasedatabase/v1beta/firebasedatabase-gen.go @@ -307,6 +307,11 @@ func (s *ListDatabaseInstancesResponse) MarshalJSON() ([]byte, error) { type ReenableDatabaseInstanceRequest struct { } +// UndeleteDatabaseInstanceRequest: The request sent to +// UndeleteDatabaseInstance method. +type UndeleteDatabaseInstanceRequest struct { +} + // method id "firebasedatabase.projects.locations.instances.create": type ProjectsLocationsInstancesCreateCall struct { @@ -1293,3 +1298,151 @@ func (c *ProjectsLocationsInstancesReenableCall) Do(opts ...googleapi.CallOption // } } + +// method id "firebasedatabase.projects.locations.instances.undelete": + +type ProjectsLocationsInstancesUndeleteCall struct { + s *Service + name string + undeletedatabaseinstancerequest *UndeleteDatabaseInstanceRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Undelete: Restores a DatabaseInstance that was previously marked to +// be deleted. This may only be used on a DatabaseInstance in the +// DELETED state. Purged DatabaseInstance's may not be recovered. +// +// - name: The fully qualified resource name of the database instance, +// in the form: +// `projects/{project-number}/locations/{location-id}/instances/{databa +// se-id}`. +func (r *ProjectsLocationsInstancesService) Undelete(name string, undeletedatabaseinstancerequest *UndeleteDatabaseInstanceRequest) *ProjectsLocationsInstancesUndeleteCall { + c := &ProjectsLocationsInstancesUndeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.undeletedatabaseinstancerequest = undeletedatabaseinstancerequest + 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 *ProjectsLocationsInstancesUndeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsInstancesUndeleteCall { + 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 *ProjectsLocationsInstancesUndeleteCall) Context(ctx context.Context) *ProjectsLocationsInstancesUndeleteCall { + 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 *ProjectsLocationsInstancesUndeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsInstancesUndeleteCall) 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.undeletedatabaseinstancerequest) + 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, "v1beta/{+name}:undelete") + 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{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "firebasedatabase.projects.locations.instances.undelete" call. +// Exactly one of *DatabaseInstance or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *DatabaseInstance.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 *ProjectsLocationsInstancesUndeleteCall) Do(opts ...googleapi.CallOption) (*DatabaseInstance, 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 := &DatabaseInstance{ + 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": "Restores a DatabaseInstance that was previously marked to be deleted. This may only be used on a DatabaseInstance in the DELETED state. Purged DatabaseInstance's may not be recovered.", + // "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:undelete", + // "httpMethod": "POST", + // "id": "firebasedatabase.projects.locations.instances.undelete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The fully qualified resource name of the database instance, in the form: `projects/{project-number}/locations/{location-id}/instances/{database-id}`", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1beta/{+name}:undelete", + // "request": { + // "$ref": "UndeleteDatabaseInstanceRequest" + // }, + // "response": { + // "$ref": "DatabaseInstance" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/firebase" + // ] + // } + +} diff --git a/networkmanagement/v1/networkmanagement-api.json b/networkmanagement/v1/networkmanagement-api.json index b09c99f9e44..094854829a3 100644 --- a/networkmanagement/v1/networkmanagement-api.json +++ b/networkmanagement/v1/networkmanagement-api.json @@ -591,7 +591,7 @@ } } }, - "revision": "20220105", + "revision": "20220323", "rootUrl": "https://networkmanagement.googleapis.com/", "schemas": { "AbortInfo": { @@ -910,7 +910,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/networkmanagement/v1/networkmanagement-gen.go b/networkmanagement/v1/networkmanagement-gen.go index d3fa1b79d80..4787802ed95 100644 --- a/networkmanagement/v1/networkmanagement-gen.go +++ b/networkmanagement/v1/networkmanagement-gen.go @@ -722,8 +722,7 @@ func (s *DropInfo) 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. diff --git a/redis/v1beta1/redis-api.json b/redis/v1beta1/redis-api.json index 0fef074f06c..9766a89b1de 100644 --- a/redis/v1beta1/redis-api.json +++ b/redis/v1beta1/redis-api.json @@ -624,11 +624,11 @@ } } }, - "revision": "20220301", + "revision": "20220325", "rootUrl": "https://redis.googleapis.com/", "schemas": { "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/redis/v1beta1/redis-gen.go b/redis/v1beta1/redis-gen.go index 5235a631b26..86e02c0c9b9 100644 --- a/redis/v1beta1/redis-gen.go +++ b/redis/v1beta1/redis-gen.go @@ -188,8 +188,7 @@ type ProjectsLocationsOperationsService struct { // 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. diff --git a/vmmigration/v1alpha1/vmmigration-api.json b/vmmigration/v1alpha1/vmmigration-api.json index 8a643f39e5f..1c9346208ec 100644 --- a/vmmigration/v1alpha1/vmmigration-api.json +++ b/vmmigration/v1alpha1/vmmigration-api.json @@ -1886,7 +1886,7 @@ } } }, - "revision": "20220306", + "revision": "20220327", "rootUrl": "https://vmmigration.googleapis.com/", "schemas": { "AddGroupMigrationRequest": { @@ -2555,7 +2555,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" @@ -3311,7 +3311,7 @@ "type": "string" }, "steps": { - "description": "The cycle's steps list reflecting its progress.", + "description": "The cycle's steps list representing its progress.", "items": { "$ref": "CycleStep" }, diff --git a/vmmigration/v1alpha1/vmmigration-gen.go b/vmmigration/v1alpha1/vmmigration-gen.go index cc79402dda6..27fefa328e7 100644 --- a/vmmigration/v1alpha1/vmmigration-gen.go +++ b/vmmigration/v1alpha1/vmmigration-gen.go @@ -1018,8 +1018,7 @@ func (s *DatacenterConnector) 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. @@ -2079,7 +2078,7 @@ type ReplicationCycle struct { // StartTime: The time the replication cycle has started. StartTime string `json:"startTime,omitempty"` - // Steps: The cycle's steps list reflecting its progress. + // Steps: The cycle's steps list representing its progress. Steps []*CycleStep `json:"steps,omitempty"` // TotalPauseDuration: The accumulated duration the replication cycle diff --git a/workflows/v1beta/workflows-api.json b/workflows/v1beta/workflows-api.json index 1f91d7b850e..e2d2b843c4f 100644 --- a/workflows/v1beta/workflows-api.json +++ b/workflows/v1beta/workflows-api.json @@ -444,11 +444,11 @@ } } }, - "revision": "20210728", + "revision": "20220323", "rootUrl": "https://workflows.googleapis.com/", "schemas": { "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/workflows/v1beta/workflows-gen.go b/workflows/v1beta/workflows-gen.go index b56adfd51b0..77c28d37d07 100644 --- a/workflows/v1beta/workflows-gen.go +++ b/workflows/v1beta/workflows-gen.go @@ -186,8 +186,7 @@ type ProjectsLocationsWorkflowsService struct { // 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. From eeb33c70f5c018db1aaee3c883165dadfe333c55 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Thu, 7 Apr 2022 07:46:30 -0700 Subject: [PATCH 05/17] feat(all): auto-regenerate discovery clients (#1503) --- .../v1/accesscontextmanager-api.json | 8 +- .../v1/accesscontextmanager-gen.go | 8 +- api-list.json | 15 + apigateway/v1beta/apigateway-api.json | 4 +- apigateway/v1beta/apigateway-gen.go | 3 +- apikeys/v2/apikeys-api.json | 46 +- apikeys/v2/apikeys-gen.go | 198 ---- artifactregistry/v1/artifactregistry-api.json | 4 +- artifactregistry/v1/artifactregistry-gen.go | 6 +- .../v1beta2/artifactregistry-api.json | 4 +- .../v1beta2/artifactregistry-gen.go | 6 +- bigtableadmin/v2/bigtableadmin-api.json | 4 +- bigtableadmin/v2/bigtableadmin-gen.go | 3 +- chat/v1/chat-api.json | 24 +- chat/v1/chat-gen.go | 36 +- chromemanagement/v1/chromemanagement-api.json | 10 +- chromemanagement/v1/chromemanagement-gen.go | 10 +- cloudbilling/v1/cloudbilling-api.json | 8 +- cloudbilling/v1/cloudbilling-gen.go | 8 +- cloudfunctions/v1/cloudfunctions-api.json | 4 +- cloudfunctions/v1/cloudfunctions-gen.go | 6 +- .../v2alpha/cloudfunctions-api.json | 34 +- cloudfunctions/v2alpha/cloudfunctions-gen.go | 56 +- cloudfunctions/v2beta/cloudfunctions-api.json | 34 +- cloudfunctions/v2beta/cloudfunctions-gen.go | 56 +- cloudidentity/v1beta1/cloudidentity-api.json | 6 +- cloudidentity/v1beta1/cloudidentity-gen.go | 3 + cloudiot/v1/cloudiot-api.json | 4 +- cloudiot/v1/cloudiot-gen.go | 3 +- .../v1/cloudresourcemanager-api.json | 8 +- .../v1/cloudresourcemanager-gen.go | 8 +- .../v1beta1/cloudresourcemanager-api.json | 8 +- .../v1beta1/cloudresourcemanager-gen.go | 8 +- .../v2/cloudresourcemanager-api.json | 8 +- .../v2/cloudresourcemanager-gen.go | 8 +- .../v2beta1/cloudresourcemanager-api.json | 8 +- .../v2beta1/cloudresourcemanager-gen.go | 8 +- .../v3/cloudresourcemanager-api.json | 167 ++- .../v3/cloudresourcemanager-gen.go | 636 +++++++++++- cloudsearch/v1/cloudsearch-api.json | 4 +- cloudsearch/v1/cloudsearch-gen.go | 5 +- cloudtrace/v1/cloudtrace-api.json | 4 +- cloudtrace/v1/cloudtrace-gen.go | 3 +- cloudtrace/v2/cloudtrace-api.json | 4 +- cloudtrace/v2/cloudtrace-gen.go | 3 +- cloudtrace/v2beta1/cloudtrace-api.json | 4 +- cloudtrace/v2beta1/cloudtrace-gen.go | 3 +- content/v2.1/content-api.json | 90 +- content/v2.1/content-gen.go | 383 ++++++- dataplex/v1/dataplex-api.json | 11 +- dataplex/v1/dataplex-gen.go | 7 +- datastore/v1/datastore-api.json | 45 +- datastore/v1/datastore-gen.go | 74 +- datastore/v1beta3/datastore-api.json | 45 +- datastore/v1beta3/datastore-gen.go | 74 +- dialogflow/v2/dialogflow-api.json | 4 +- dialogflow/v2/dialogflow-gen.go | 6 +- dialogflow/v2beta1/dialogflow-api.json | 4 +- dialogflow/v2beta1/dialogflow-gen.go | 6 +- dialogflow/v3/dialogflow-api.json | 4 +- dialogflow/v3/dialogflow-gen.go | 6 +- dialogflow/v3beta1/dialogflow-api.json | 4 +- dialogflow/v3beta1/dialogflow-gen.go | 6 +- docs/v1/docs-api.json | 10 +- docs/v1/docs-gen.go | 14 +- .../v1.1/doubleclickbidmanager-api.json | 10 +- .../v1.1/doubleclickbidmanager-gen.go | 5 - eventarc/v1/eventarc-api.json | 4 +- eventarc/v1/eventarc-gen.go | 6 +- fcmdata/v1beta1/fcmdata-api.json | 4 +- fcmdata/v1beta1/fcmdata-gen.go | 5 +- .../v1beta/firebaseappcheck-api.json | 220 +++- .../v1beta/firebaseappcheck-gen.go | 970 +++++++++++++++++- firestore/v1/firestore-api.json | 146 ++- firestore/v1/firestore-gen.go | 392 ++++++- firestore/v1beta1/firestore-api.json | 144 ++- firestore/v1beta1/firestore-gen.go | 386 ++++++- games/v1/games-api.json | 6 +- games/v1/games-gen.go | 3 + gmail/v1/gmail-api.json | 4 +- gmail/v1/gmail-gen.go | 4 +- logging/v2/logging-api.json | 40 +- logging/v2/logging-gen.go | 49 + .../v1/networkconnectivity-api.json | 10 +- .../v1/networkconnectivity-gen.go | 14 +- policysimulator/v1/policysimulator-api.json | 4 +- policysimulator/v1/policysimulator-gen.go | 4 +- .../v1beta1/policysimulator-api.json | 4 +- .../v1beta1/policysimulator-gen.go | 4 +- .../v1/policytroubleshooter-api.json | 4 +- .../v1/policytroubleshooter-gen.go | 4 +- .../v1beta/policytroubleshooter-api.json | 4 +- .../v1beta/policytroubleshooter-gen.go | 4 +- privateca/v1/privateca-api.json | 4 +- privateca/v1/privateca-gen.go | 3 +- privateca/v1beta1/privateca-api.json | 4 +- privateca/v1beta1/privateca-gen.go | 3 +- redis/v1/redis-api.json | 6 +- redis/v1/redis-gen.go | 9 +- redis/v1beta1/redis-api.json | 4 +- redis/v1beta1/redis-gen.go | 6 +- run/v1/run-api.json | 92 +- run/v1/run-gen.go | 296 +++--- run/v2/run-api.json | 14 +- run/v2/run-gen.go | 8 +- securitycenter/v1/securitycenter-api.json | 42 +- securitycenter/v1/securitycenter-gen.go | 48 + .../v1beta1/securitycenter-api.json | 42 +- securitycenter/v1beta1/securitycenter-gen.go | 48 + .../v1beta2/securitycenter-api.json | 142 ++- securitycenter/v1beta2/securitycenter-gen.go | 544 ++++++++++ .../v1/serviceconsumermanagement-api.json | 8 +- .../v1/serviceconsumermanagement-gen.go | 19 +- .../serviceconsumermanagement-api.json | 8 +- .../v1beta1/serviceconsumermanagement-gen.go | 19 +- .../v1/servicemanagement-api.json | 26 +- servicemanagement/v1/servicemanagement-gen.go | 72 +- serviceusage/v1/serviceusage-api.json | 8 +- serviceusage/v1/serviceusage-gen.go | 19 +- serviceusage/v1beta1/serviceusage-api.json | 8 +- serviceusage/v1beta1/serviceusage-gen.go | 19 +- sourcerepo/v1/sourcerepo-api.json | 8 +- sourcerepo/v1/sourcerepo-gen.go | 8 +- spanner/v1/spanner-api.json | 132 ++- spanner/v1/spanner-gen.go | 677 +++++++++++- storage/v1/storage-api.json | 234 +---- storage/v1/storage-gen.go | 598 ----------- sts/v1/sts-api.json | 4 +- sts/v1/sts-gen.go | 4 +- sts/v1beta/sts-api.json | 4 +- sts/v1beta/sts-gen.go | 4 +- transcoder/v1/transcoder-api.json | 26 +- transcoder/v1/transcoder-gen.go | 39 +- translate/v3/translate-api.json | 6 +- translate/v3/translate-gen.go | 9 +- translate/v3beta1/translate-api.json | 6 +- translate/v3beta1/translate-gen.go | 9 +- vault/v1/vault-api.json | 20 +- vault/v1/vault-gen.go | 47 +- youtube/v3/youtube-api.json | 4 +- youtube/v3/youtube-gen.go | 2 +- 141 files changed, 6358 insertions(+), 1759 deletions(-) diff --git a/accesscontextmanager/v1/accesscontextmanager-api.json b/accesscontextmanager/v1/accesscontextmanager-api.json index 89b0389614b..6b149efd901 100644 --- a/accesscontextmanager/v1/accesscontextmanager-api.json +++ b/accesscontextmanager/v1/accesscontextmanager-api.json @@ -1083,7 +1083,7 @@ } } }, - "revision": "20220318", + "revision": "20220402", "rootUrl": "https://accesscontextmanager.googleapis.com/", "schemas": { "AccessContextManagerOperationMetadata": { @@ -1250,7 +1250,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" }, @@ -2013,7 +2013,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\"`", @@ -2055,7 +2055,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/accesscontextmanager/v1/accesscontextmanager-gen.go b/accesscontextmanager/v1/accesscontextmanager-gen.go index 78336e9c291..08505ec1c3e 100644 --- a/accesscontextmanager/v1/accesscontextmanager-gen.go +++ b/accesscontextmanager/v1/accesscontextmanager-gen.go @@ -523,8 +523,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 @@ -2096,7 +2096,7 @@ func (s *ServicePerimeterConfig) 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"` @@ -2177,7 +2177,7 @@ func (s *Status) 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"` diff --git a/api-list.json b/api-list.json index 140751ba04a..f7da025b27f 100644 --- a/api-list.json +++ b/api-list.json @@ -272,6 +272,21 @@ "documentationLink": "https://developers.google.com/analytics/devguides/reporting/data/v1/", "preferred": true }, + { + "kind": "discovery#directoryItem", + "id": "analyticshub:v1beta1", + "name": "analyticshub", + "version": "v1beta1", + "title": "Analytics Hub API", + "description": "Exchange data and analytics assets securely and efficiently.", + "discoveryRestUrl": "https://analyticshub.googleapis.com/$discovery/rest?version=v1beta1", + "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/analytics-hub/", + "preferred": true + }, { "kind": "discovery#directoryItem", "id": "analyticsreporting:v4", diff --git a/apigateway/v1beta/apigateway-api.json b/apigateway/v1beta/apigateway-api.json index 5b18adcdab9..d294057fda2 100644 --- a/apigateway/v1beta/apigateway-api.json +++ b/apigateway/v1beta/apigateway-api.json @@ -1083,7 +1083,7 @@ } } }, - "revision": "20211110", + "revision": "20220323", "rootUrl": "https://apigateway.googleapis.com/", "schemas": { "ApigatewayApi": { @@ -1819,7 +1819,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/apigateway/v1beta/apigateway-gen.go b/apigateway/v1beta/apigateway-gen.go index bf228b8173f..66fbaf9db25 100644 --- a/apigateway/v1beta/apigateway-gen.go +++ b/apigateway/v1beta/apigateway-gen.go @@ -1501,8 +1501,7 @@ func (s *ApigatewayTestIamPermissionsResponse) 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. diff --git a/apikeys/v2/apikeys-api.json b/apikeys/v2/apikeys-api.json index d1794634074..1e9ab57291b 100644 --- a/apikeys/v2/apikeys-api.json +++ b/apikeys/v2/apikeys-api.json @@ -170,34 +170,6 @@ "resources": { "keys": { "methods": { - "clone": { - "description": "DEPRECATED: API customers can call `GetKey` and then `CreateKey` methods to create a copy of an existing key. Retire `CloneKey` method to eliminate the unnessary method from API Keys API. Clones the existing key's restriction and display name to a new API key. The service account must have the `apikeys.keys.get` and `apikeys.keys.create` permissions in the project. NOTE: Key is a global resource; hence the only supported value for location is `global`.", - "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/keys/{keysId}:clone", - "httpMethod": "POST", - "id": "apikeys.projects.locations.keys.clone", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Required. The resource name of the API key to be cloned in the same project.", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/keys/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v2/{+name}:clone", - "request": { - "$ref": "V2CloneKeyRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, "create": { "description": "Creates a new API key. NOTE: Key is a global resource; hence the only supported value for location is `global`.", "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/keys", @@ -322,11 +294,6 @@ "parent" ], "parameters": { - "filter": { - "description": "Optional. Deprecated: Use `show_deleted` instead. Only list keys that conform to the specified filter. The allowed filter strings are `state:ACTIVE` and `state:DELETED`. By default, ListKeys returns only active keys.", - "location": "query", - "type": "string" - }, "pageSize": { "description": "Optional. Specifies the maximum number of results to be returned at a time.", "format": "int32", @@ -429,7 +396,7 @@ } } }, - "revision": "20220330", + "revision": "20220405", "rootUrl": "https://apikeys.googleapis.com/", "schemas": { "Operation": { @@ -555,17 +522,6 @@ }, "type": "object" }, - "V2CloneKeyRequest": { - "description": "Request message for `CloneKey` method.", - "id": "V2CloneKeyRequest", - "properties": { - "keyId": { - "description": "User specified key id (optional). If specified, it will become the final component of the key resource name. The id must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. In another word, the id must match the regular expression: `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`. The id must NOT be a UUID-like string.", - "type": "string" - } - }, - "type": "object" - }, "V2GetKeyStringResponse": { "description": "Response message for `GetKeyString` method.", "id": "V2GetKeyStringResponse", diff --git a/apikeys/v2/apikeys-gen.go b/apikeys/v2/apikeys-gen.go index b79880ef854..777a164e452 100644 --- a/apikeys/v2/apikeys-gen.go +++ b/apikeys/v2/apikeys-gen.go @@ -446,40 +446,6 @@ func (s *V2BrowserKeyRestrictions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// V2CloneKeyRequest: Request message for `CloneKey` method. -type V2CloneKeyRequest struct { - // KeyId: User specified key id (optional). If specified, it will become - // the final component of the key resource name. The id must be unique - // within the project, must conform with RFC-1034, is restricted to - // lower-cased letters, and has a maximum length of 63 characters. In - // another word, the id must match the regular expression: - // `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`. The id must NOT be a UUID-like - // string. - KeyId string `json:"keyId,omitempty"` - - // ForceSendFields is a list of field names (e.g. "KeyId") 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. "KeyId") 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 *V2CloneKeyRequest) MarshalJSON() ([]byte, error) { - type NoMethod V2CloneKeyRequest - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // V2GetKeyStringResponse: Response message for `GetKeyString` method. type V2GetKeyStringResponse struct { // KeyString: An encrypted and signed value of the key. @@ -1066,156 +1032,6 @@ func (c *OperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, error) } -// method id "apikeys.projects.locations.keys.clone": - -type ProjectsLocationsKeysCloneCall struct { - s *Service - name string - v2clonekeyrequest *V2CloneKeyRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Clone: DEPRECATED: API customers can call `GetKey` and then -// `CreateKey` methods to create a copy of an existing key. Retire -// `CloneKey` method to eliminate the unnessary method from API Keys -// API. Clones the existing key's restriction and display name to a new -// API key. The service account must have the `apikeys.keys.get` and -// `apikeys.keys.create` permissions in the project. NOTE: Key is a -// global resource; hence the only supported value for location is -// `global`. -// -// - name: The resource name of the API key to be cloned in the same -// project. -func (r *ProjectsLocationsKeysService) Clone(name string, v2clonekeyrequest *V2CloneKeyRequest) *ProjectsLocationsKeysCloneCall { - c := &ProjectsLocationsKeysCloneCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.v2clonekeyrequest = v2clonekeyrequest - 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 *ProjectsLocationsKeysCloneCall) Fields(s ...googleapi.Field) *ProjectsLocationsKeysCloneCall { - 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 *ProjectsLocationsKeysCloneCall) Context(ctx context.Context) *ProjectsLocationsKeysCloneCall { - 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 *ProjectsLocationsKeysCloneCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsKeysCloneCall) 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.v2clonekeyrequest) - 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, "v2/{+name}:clone") - 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{ - "name": c.name, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "apikeys.projects.locations.keys.clone" call. -// Exactly one of *Operation or error will be non-nil. Any non-2xx -// status code is an error. Response headers are in either -// *Operation.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 *ProjectsLocationsKeysCloneCall) Do(opts ...googleapi.CallOption) (*Operation, 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 := &Operation{ - 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": "DEPRECATED: API customers can call `GetKey` and then `CreateKey` methods to create a copy of an existing key. Retire `CloneKey` method to eliminate the unnessary method from API Keys API. Clones the existing key's restriction and display name to a new API key. The service account must have the `apikeys.keys.get` and `apikeys.keys.create` permissions in the project. NOTE: Key is a global resource; hence the only supported value for location is `global`.", - // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/keys/{keysId}:clone", - // "httpMethod": "POST", - // "id": "apikeys.projects.locations.keys.clone", - // "parameterOrder": [ - // "name" - // ], - // "parameters": { - // "name": { - // "description": "Required. The resource name of the API key to be cloned in the same project.", - // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/keys/[^/]+$", - // "required": true, - // "type": "string" - // } - // }, - // "path": "v2/{+name}:clone", - // "request": { - // "$ref": "V2CloneKeyRequest" - // }, - // "response": { - // "$ref": "Operation" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform" - // ] - // } - -} - // method id "apikeys.projects.locations.keys.create": type ProjectsLocationsKeysCreateCall struct { @@ -1844,15 +1660,6 @@ func (r *ProjectsLocationsKeysService) List(parent string) *ProjectsLocationsKey return c } -// Filter sets the optional parameter "filter": Deprecated: Use -// `show_deleted` instead. Only list keys that conform to the specified -// filter. The allowed filter strings are `state:ACTIVE` and -// `state:DELETED`. By default, ListKeys returns only active keys. -func (c *ProjectsLocationsKeysListCall) Filter(filter string) *ProjectsLocationsKeysListCall { - c.urlParams_.Set("filter", filter) - return c -} - // PageSize sets the optional parameter "pageSize": Specifies the // maximum number of results to be returned at a time. func (c *ProjectsLocationsKeysListCall) PageSize(pageSize int64) *ProjectsLocationsKeysListCall { @@ -1981,11 +1788,6 @@ func (c *ProjectsLocationsKeysListCall) Do(opts ...googleapi.CallOption) (*V2Lis // "parent" // ], // "parameters": { - // "filter": { - // "description": "Optional. Deprecated: Use `show_deleted` instead. Only list keys that conform to the specified filter. The allowed filter strings are `state:ACTIVE` and `state:DELETED`. By default, ListKeys returns only active keys.", - // "location": "query", - // "type": "string" - // }, // "pageSize": { // "description": "Optional. Specifies the maximum number of results to be returned at a time.", // "format": "int32", diff --git a/artifactregistry/v1/artifactregistry-api.json b/artifactregistry/v1/artifactregistry-api.json index b1fddd81c6a..3c52b9447db 100644 --- a/artifactregistry/v1/artifactregistry-api.json +++ b/artifactregistry/v1/artifactregistry-api.json @@ -210,7 +210,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" }, @@ -1207,7 +1207,7 @@ } } }, - "revision": "20220328", + "revision": "20220401", "rootUrl": "https://artifactregistry.googleapis.com/", "schemas": { "AptArtifact": { diff --git a/artifactregistry/v1/artifactregistry-gen.go b/artifactregistry/v1/artifactregistry-gen.go index 677bb6e71f4..f1b17811251 100644 --- a/artifactregistry/v1/artifactregistry-gen.go +++ b/artifactregistry/v1/artifactregistry-gen.go @@ -2476,8 +2476,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 @@ -2606,7 +2606,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/artifactregistry/v1beta2/artifactregistry-api.json b/artifactregistry/v1beta2/artifactregistry-api.json index 685de17f7a1..f02285cd73d 100644 --- a/artifactregistry/v1beta2/artifactregistry-api.json +++ b/artifactregistry/v1beta2/artifactregistry-api.json @@ -210,7 +210,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" }, @@ -1135,7 +1135,7 @@ } } }, - "revision": "20220328", + "revision": "20220401", "rootUrl": "https://artifactregistry.googleapis.com/", "schemas": { "AptArtifact": { diff --git a/artifactregistry/v1beta2/artifactregistry-gen.go b/artifactregistry/v1beta2/artifactregistry-gen.go index 9a2e1dc2fb1..d45d66f2ee3 100644 --- a/artifactregistry/v1beta2/artifactregistry-gen.go +++ b/artifactregistry/v1beta2/artifactregistry-gen.go @@ -2358,8 +2358,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 @@ -2488,7 +2488,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/bigtableadmin/v2/bigtableadmin-api.json b/bigtableadmin/v2/bigtableadmin-api.json index 640e81a9569..cb78e19e017 100644 --- a/bigtableadmin/v2/bigtableadmin-api.json +++ b/bigtableadmin/v2/bigtableadmin-api.json @@ -1803,7 +1803,7 @@ } } }, - "revision": "20220313", + "revision": "20220329", "rootUrl": "https://bigtableadmin.googleapis.com/", "schemas": { "AppProfile": { @@ -2333,7 +2333,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/bigtableadmin/v2/bigtableadmin-gen.go b/bigtableadmin/v2/bigtableadmin-gen.go index 86d72e6c061..01fa9fe2f37 100644 --- a/bigtableadmin/v2/bigtableadmin-gen.go +++ b/bigtableadmin/v2/bigtableadmin-gen.go @@ -1295,8 +1295,7 @@ func (s *DropRowRangeRequest) 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. diff --git a/chat/v1/chat-api.json b/chat/v1/chat-api.json index b04dce5edad..571c431560d 100644 --- a/chat/v1/chat-api.json +++ b/chat/v1/chat-api.json @@ -642,7 +642,7 @@ } } }, - "revision": "20220326", + "revision": "20220329", "rootUrl": "https://chat.googleapis.com/", "schemas": { "ActionParameter": { @@ -666,10 +666,10 @@ "properties": { "dialogAction": { "$ref": "DialogAction", - "description": "A response to an event related to a [dialog](https://developers.google.com/chat/how-tos/dialogs). Must be accompanied by `ResponseType.Dialog`." + "description": "Input only. A response to an event related to a [dialog](https://developers.google.com/chat/how-tos/dialogs). Must be accompanied by `ResponseType.Dialog`." }, "type": { - "description": "The type of Chat app response.", + "description": "Input only. The type of Chat app response.", "enum": [ "TYPE_UNSPECIFIED", "NEW_MESSAGE", @@ -689,7 +689,7 @@ "type": "string" }, "url": { - "description": "URL for users to auth or config. (Only for REQUEST_CONFIG response types.)", + "description": "Input only. URL for users to auth or config. (Only for REQUEST_CONFIG response types.)", "type": "string" } }, @@ -1162,7 +1162,7 @@ "properties": { "body": { "$ref": "GoogleAppsCardV1Card", - "description": "Body of the dialog, which is rendered in a modal. Google Chat apps do not support the following card entities: `DateTimePicker`, `OnChangeAction`." + "description": "Input only. Body of the dialog, which is rendered in a modal. Google Chat apps do not support the following card entities: `DateTimePicker`, `OnChangeAction`." } }, "type": "object" @@ -1173,11 +1173,11 @@ "properties": { "actionStatus": { "$ref": "ActionStatus", - "description": "Status for a request to either invoke or submit a [dialog](https://developers.google.com/chat/how-tos/dialogs). Displays a status and message to users, if necessary. For example, in case of an error or success." + "description": "Input only. Status for a request to either invoke or submit a [dialog](https://developers.google.com/chat/how-tos/dialogs). Displays a status and message to users, if necessary. For example, in case of an error or success." }, "dialog": { "$ref": "Dialog", - "description": "[Dialog](https://developers.google.com/chat/how-tos/dialogs) for the request." + "description": "Input only. [Dialog](https://developers.google.com/chat/how-tos/dialogs) for the request." } }, "type": "object" @@ -2426,6 +2426,7 @@ "items": { "$ref": "Annotation" }, + "readOnly": true, "type": "array" }, "argumentText": { @@ -2464,7 +2465,8 @@ }, "matchedUrl": { "$ref": "MatchedUrl", - "description": "A URL in `spaces.messages.text` that matches a link unfurling pattern. For more information, refer to [Unfurl links](/chat/how-tos/link-unfurling)." + "description": "Output only. A URL in `spaces.messages.text` that matches a link unfurling pattern. For more information, refer to [Unfurl links](https://developers.google.com/chat/how-tos/link-unfurling).", + "readOnly": true }, "name": { "description": "Resource name in the form `spaces/*/messages/*`. Example: `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`", @@ -2472,11 +2474,13 @@ }, "sender": { "$ref": "User", - "description": "The user who created the message." + "description": "Output only. The user who created the message.", + "readOnly": true }, "slashCommand": { "$ref": "SlashCommand", - "description": "Slash command information, if applicable." + "description": "Output only. Slash command information, if applicable.", + "readOnly": true }, "space": { "$ref": "Space", diff --git a/chat/v1/chat-gen.go b/chat/v1/chat-gen.go index b648da7639e..19bca7992c5 100644 --- a/chat/v1/chat-gen.go +++ b/chat/v1/chat-gen.go @@ -268,12 +268,12 @@ func (s *ActionParameter) MarshalJSON() ([]byte, error) { // ActionResponse: Parameters that a Chat app can use to configure how // it's response is posted. type ActionResponse struct { - // DialogAction: A response to an event related to a dialog + // DialogAction: Input only. A response to an event related to a dialog // (https://developers.google.com/chat/how-tos/dialogs). Must be // accompanied by `ResponseType.Dialog`. DialogAction *DialogAction `json:"dialogAction,omitempty"` - // Type: The type of Chat app response. + // Type: Input only. The type of Chat app response. // // Possible values: // "TYPE_UNSPECIFIED" - Default type; will be handled as NEW_MESSAGE. @@ -291,8 +291,8 @@ type ActionResponse struct { // [dialog](https://developers.google.com/chat/how-tos/dialogs). Type string `json:"type,omitempty"` - // Url: URL for users to auth or config. (Only for REQUEST_CONFIG - // response types.) + // Url: Input only. URL for users to auth or config. (Only for + // REQUEST_CONFIG response types.) Url string `json:"url,omitempty"` // ForceSendFields is a list of field names (e.g. "DialogAction") to @@ -1104,9 +1104,9 @@ func (s *DeprecatedEvent) MarshalJSON() ([]byte, error) { // Dialog: Wrapper around the card body of the dialog. type Dialog struct { - // Body: Body of the dialog, which is rendered in a modal. Google Chat - // apps do not support the following card entities: `DateTimePicker`, - // `OnChangeAction`. + // Body: Input only. Body of the dialog, which is rendered in a modal. + // Google Chat apps do not support the following card entities: + // `DateTimePicker`, `OnChangeAction`. Body *GoogleAppsCardV1Card `json:"body,omitempty"` // ForceSendFields is a list of field names (e.g. "Body") to @@ -1136,14 +1136,14 @@ func (s *Dialog) MarshalJSON() ([]byte, error) { // (https://developers.google.com/chat/how-tos/dialogs) and request // status code. type DialogAction struct { - // ActionStatus: Status for a request to either invoke or submit a - // dialog (https://developers.google.com/chat/how-tos/dialogs). Displays - // a status and message to users, if necessary. For example, in case of - // an error or success. + // ActionStatus: Input only. Status for a request to either invoke or + // submit a dialog (https://developers.google.com/chat/how-tos/dialogs). + // Displays a status and message to users, if necessary. For example, in + // case of an error or success. ActionStatus *ActionStatus `json:"actionStatus,omitempty"` - // Dialog: Dialog (https://developers.google.com/chat/how-tos/dialogs) - // for the request. + // Dialog: Input only. Dialog + // (https://developers.google.com/chat/how-tos/dialogs) for the request. Dialog *Dialog `json:"dialog,omitempty"` // ForceSendFields is a list of field names (e.g. "ActionStatus") to @@ -3096,19 +3096,19 @@ type Message struct { // field will be same as create_time. LastUpdateTime string `json:"lastUpdateTime,omitempty"` - // MatchedUrl: A URL in `spaces.messages.text` that matches a link - // unfurling pattern. For more information, refer to Unfurl links - // (/chat/how-tos/link-unfurling). + // MatchedUrl: Output only. A URL in `spaces.messages.text` that matches + // a link unfurling pattern. For more information, refer to Unfurl links + // (https://developers.google.com/chat/how-tos/link-unfurling). MatchedUrl *MatchedUrl `json:"matchedUrl,omitempty"` // Name: Resource name in the form `spaces/*/messages/*`. Example: // `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB` Name string `json:"name,omitempty"` - // Sender: The user who created the message. + // Sender: Output only. The user who created the message. Sender *User `json:"sender,omitempty"` - // SlashCommand: Slash command information, if applicable. + // SlashCommand: Output only. Slash command information, if applicable. SlashCommand *SlashCommand `json:"slashCommand,omitempty"` // Space: The space the message belongs to. diff --git a/chromemanagement/v1/chromemanagement-api.json b/chromemanagement/v1/chromemanagement-api.json index 54a98ba4d7d..3cb89f7ae64 100644 --- a/chromemanagement/v1/chromemanagement-api.json +++ b/chromemanagement/v1/chromemanagement-api.json @@ -488,7 +488,7 @@ } } }, - "revision": "20220331", + "revision": "20220405", "rootUrl": "https://chromemanagement.googleapis.com/", "schemas": { "GoogleChromeManagementV1AndroidAppInfo": { @@ -814,7 +814,7 @@ "type": "string" }, "sample": { - "description": "Output only. Sampling data for the battery.", + "description": "Output only. Sampling data for the battery sorted in a decreasing order of report_time.", "items": { "$ref": "GoogleChromeManagementV1BatterySampleReport" }, @@ -1734,7 +1734,7 @@ "id": "GoogleChromeManagementV1TelemetryDevice", "properties": { "audioStatusReport": { - "description": "Output only. Audio reports collected periodically.", + "description": "Output only. Audio reports collected periodically sorted in a decreasing order of report_time.", "items": { "$ref": "GoogleChromeManagementV1AudioStatusReport" }, @@ -1766,7 +1766,7 @@ "type": "array" }, "cpuStatusReport": { - "description": "Output only. CPU status reports collected periodically.", + "description": "Output only. CPU status reports collected periodically sorted in a decreasing order of report_time.", "items": { "$ref": "GoogleChromeManagementV1CpuStatusReport" }, @@ -1802,7 +1802,7 @@ "readOnly": true }, "memoryStatusReport": { - "description": "Output only. Memory status reports collected periodically.", + "description": "Output only. Memory status reports collected periodically sorted decreasing by report_time.", "items": { "$ref": "GoogleChromeManagementV1MemoryStatusReport" }, diff --git a/chromemanagement/v1/chromemanagement-gen.go b/chromemanagement/v1/chromemanagement-gen.go index d7cdafbd842..da76b27dfe6 100644 --- a/chromemanagement/v1/chromemanagement-gen.go +++ b/chromemanagement/v1/chromemanagement-gen.go @@ -594,7 +594,8 @@ type GoogleChromeManagementV1BatteryStatusReport struct { // on device ReportTime string `json:"reportTime,omitempty"` - // Sample: Output only. Sampling data for the battery. + // Sample: Output only. Sampling data for the battery sorted in a + // decreasing order of report_time. Sample []*GoogleChromeManagementV1BatterySampleReport `json:"sample,omitempty"` // SerialNumber: Output only. Battery serial number. @@ -1790,7 +1791,8 @@ func (s *GoogleChromeManagementV1StorageStatusReport) MarshalJSON() ([]byte, err // GoogleChromeManagementV1TelemetryDevice: Telemetry data collected // from a managed device. type GoogleChromeManagementV1TelemetryDevice struct { - // AudioStatusReport: Output only. Audio reports collected periodically. + // AudioStatusReport: Output only. Audio reports collected periodically + // sorted in a decreasing order of report_time. AudioStatusReport []*GoogleChromeManagementV1AudioStatusReport `json:"audioStatusReport,omitempty"` // BatteryInfo: Output only. Information on battery specs for the @@ -1805,7 +1807,7 @@ type GoogleChromeManagementV1TelemetryDevice struct { CpuInfo []*GoogleChromeManagementV1CpuInfo `json:"cpuInfo,omitempty"` // CpuStatusReport: Output only. CPU status reports collected - // periodically. + // periodically sorted in a decreasing order of report_time. CpuStatusReport []*GoogleChromeManagementV1CpuStatusReport `json:"cpuStatusReport,omitempty"` // Customer: Output only. Google Workspace Customer whose enterprise @@ -1830,7 +1832,7 @@ type GoogleChromeManagementV1TelemetryDevice struct { MemoryInfo *GoogleChromeManagementV1MemoryInfo `json:"memoryInfo,omitempty"` // MemoryStatusReport: Output only. Memory status reports collected - // periodically. + // periodically sorted decreasing by report_time. MemoryStatusReport []*GoogleChromeManagementV1MemoryStatusReport `json:"memoryStatusReport,omitempty"` // Name: Output only. Resource name of the device. diff --git a/cloudbilling/v1/cloudbilling-api.json b/cloudbilling/v1/cloudbilling-api.json index 9c67348535d..37d1acf4690 100644 --- a/cloudbilling/v1/cloudbilling-api.json +++ b/cloudbilling/v1/cloudbilling-api.json @@ -521,7 +521,7 @@ } } }, - "revision": "20211211", + "revision": "20220402", "rootUrl": "https://cloudbilling.googleapis.com/", "schemas": { "AggregationInfo": { @@ -644,7 +644,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" }, @@ -978,7 +978,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\"`", @@ -1038,7 +1038,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/cloudbilling/v1/cloudbilling-gen.go b/cloudbilling/v1/cloudbilling-gen.go index 317469952fe..db713ade363 100644 --- a/cloudbilling/v1/cloudbilling-gen.go +++ b/cloudbilling/v1/cloudbilling-gen.go @@ -413,8 +413,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 @@ -1177,7 +1177,7 @@ func (s *Service) 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"` @@ -1270,7 +1270,7 @@ func (s *Sku) 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"` diff --git a/cloudfunctions/v1/cloudfunctions-api.json b/cloudfunctions/v1/cloudfunctions-api.json index 7c751bf3268..b3dbb67e9c2 100644 --- a/cloudfunctions/v1/cloudfunctions-api.json +++ b/cloudfunctions/v1/cloudfunctions-api.json @@ -185,7 +185,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" }, @@ -546,7 +546,7 @@ } } }, - "revision": "20220317", + "revision": "20220331", "rootUrl": "https://cloudfunctions.googleapis.com/", "schemas": { "AuditConfig": { diff --git a/cloudfunctions/v1/cloudfunctions-gen.go b/cloudfunctions/v1/cloudfunctions-gen.go index b9627dc43ac..75d410dc657 100644 --- a/cloudfunctions/v1/cloudfunctions-gen.go +++ b/cloudfunctions/v1/cloudfunctions-gen.go @@ -2457,8 +2457,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 @@ -2587,7 +2587,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/cloudfunctions/v2alpha/cloudfunctions-api.json b/cloudfunctions/v2alpha/cloudfunctions-api.json index 8a854b6c2eb..86347f443aa 100644 --- a/cloudfunctions/v2alpha/cloudfunctions-api.json +++ b/cloudfunctions/v2alpha/cloudfunctions-api.json @@ -119,7 +119,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" }, @@ -571,7 +571,7 @@ } } }, - "revision": "20220317", + "revision": "20220331", "rootUrl": "https://cloudfunctions.googleapis.com/", "schemas": { "AuditConfig": { @@ -1519,6 +1519,29 @@ }, "type": "object" }, + "SecretEnvVar": { + "description": "Configuration for a secret environment variable. It has the information necessary to fetch the secret value from secret manager and expose it as an environment variable.", + "id": "SecretEnvVar", + "properties": { + "key": { + "description": "Name of the environment variable.", + "type": "string" + }, + "projectId": { + "description": "Project identifier (preferably project number but can also be the project ID) of the project that contains the secret. If not set, it will be populated with the function's project assuming that the secret exists in the same project as of the function.", + "type": "string" + }, + "secret": { + "description": "Name of the secret in secret manager (not the full resource name).", + "type": "string" + }, + "version": { + "description": "Version of the secret (version number or the string 'latest'). It is recommended to use a numeric version for secret environment variables as any updates to the secret value is not reflected until new instances start.", + "type": "string" + } + }, + "type": "object" + }, "ServiceConfig": { "description": "Describes the Service being deployed. Currently Supported : Cloud Run (fully managed).", "id": "ServiceConfig", @@ -1569,6 +1592,13 @@ "readOnly": true, "type": "string" }, + "secretEnvironmentVariables": { + "description": "Secret environment variables configuration.", + "items": { + "$ref": "SecretEnvVar" + }, + "type": "array" + }, "service": { "description": "Output only. Name of the service associated with a Function. The format of this field is `projects/{project}/locations/{region}/services/{service}`", "readOnly": true, diff --git a/cloudfunctions/v2alpha/cloudfunctions-gen.go b/cloudfunctions/v2alpha/cloudfunctions-gen.go index 06f5ae04d62..a54de080597 100644 --- a/cloudfunctions/v2alpha/cloudfunctions-gen.go +++ b/cloudfunctions/v2alpha/cloudfunctions-gen.go @@ -1630,6 +1630,52 @@ func (s *Runtime) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// SecretEnvVar: Configuration for a secret environment variable. It has +// the information necessary to fetch the secret value from secret +// manager and expose it as an environment variable. +type SecretEnvVar struct { + // Key: Name of the environment variable. + Key string `json:"key,omitempty"` + + // ProjectId: Project identifier (preferably project number but can also + // be the project ID) of the project that contains the secret. If not + // set, it will be populated with the function's project assuming that + // the secret exists in the same project as of the function. + ProjectId string `json:"projectId,omitempty"` + + // Secret: Name of the secret in secret manager (not the full resource + // name). + Secret string `json:"secret,omitempty"` + + // Version: Version of the secret (version number or the string + // 'latest'). It is recommended to use a numeric version for secret + // environment variables as any updates to the secret value is not + // reflected until new instances start. + Version string `json:"version,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Key") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. 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. "Key") 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 *SecretEnvVar) MarshalJSON() ([]byte, error) { + type NoMethod SecretEnvVar + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ServiceConfig: Describes the Service being deployed. Currently // Supported : Cloud Run (fully managed). type ServiceConfig struct { @@ -1687,6 +1733,10 @@ type ServiceConfig struct { // Revision: Output only. The name of service revision. Revision string `json:"revision,omitempty"` + // SecretEnvironmentVariables: Secret environment variables + // configuration. + SecretEnvironmentVariables []*SecretEnvVar `json:"secretEnvironmentVariables,omitempty"` + // Service: Output only. Name of the service associated with a Function. // The format of this field is // `projects/{project}/locations/{region}/services/{service}` @@ -2025,8 +2075,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 @@ -2155,7 +2205,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/cloudfunctions/v2beta/cloudfunctions-api.json b/cloudfunctions/v2beta/cloudfunctions-api.json index 3008bd1fdfe..f047af974e8 100644 --- a/cloudfunctions/v2beta/cloudfunctions-api.json +++ b/cloudfunctions/v2beta/cloudfunctions-api.json @@ -119,7 +119,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" }, @@ -571,7 +571,7 @@ } } }, - "revision": "20220317", + "revision": "20220331", "rootUrl": "https://cloudfunctions.googleapis.com/", "schemas": { "AuditConfig": { @@ -1519,6 +1519,29 @@ }, "type": "object" }, + "SecretEnvVar": { + "description": "Configuration for a secret environment variable. It has the information necessary to fetch the secret value from secret manager and expose it as an environment variable.", + "id": "SecretEnvVar", + "properties": { + "key": { + "description": "Name of the environment variable.", + "type": "string" + }, + "projectId": { + "description": "Project identifier (preferably project number but can also be the project ID) of the project that contains the secret. If not set, it will be populated with the function's project assuming that the secret exists in the same project as of the function.", + "type": "string" + }, + "secret": { + "description": "Name of the secret in secret manager (not the full resource name).", + "type": "string" + }, + "version": { + "description": "Version of the secret (version number or the string 'latest'). It is recommended to use a numeric version for secret environment variables as any updates to the secret value is not reflected until new instances start.", + "type": "string" + } + }, + "type": "object" + }, "ServiceConfig": { "description": "Describes the Service being deployed. Currently Supported : Cloud Run (fully managed).", "id": "ServiceConfig", @@ -1569,6 +1592,13 @@ "readOnly": true, "type": "string" }, + "secretEnvironmentVariables": { + "description": "Secret environment variables configuration.", + "items": { + "$ref": "SecretEnvVar" + }, + "type": "array" + }, "service": { "description": "Output only. Name of the service associated with a Function. The format of this field is `projects/{project}/locations/{region}/services/{service}`", "readOnly": true, diff --git a/cloudfunctions/v2beta/cloudfunctions-gen.go b/cloudfunctions/v2beta/cloudfunctions-gen.go index 3d0f9a8a98a..f363e19bd80 100644 --- a/cloudfunctions/v2beta/cloudfunctions-gen.go +++ b/cloudfunctions/v2beta/cloudfunctions-gen.go @@ -1630,6 +1630,52 @@ func (s *Runtime) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// SecretEnvVar: Configuration for a secret environment variable. It has +// the information necessary to fetch the secret value from secret +// manager and expose it as an environment variable. +type SecretEnvVar struct { + // Key: Name of the environment variable. + Key string `json:"key,omitempty"` + + // ProjectId: Project identifier (preferably project number but can also + // be the project ID) of the project that contains the secret. If not + // set, it will be populated with the function's project assuming that + // the secret exists in the same project as of the function. + ProjectId string `json:"projectId,omitempty"` + + // Secret: Name of the secret in secret manager (not the full resource + // name). + Secret string `json:"secret,omitempty"` + + // Version: Version of the secret (version number or the string + // 'latest'). It is recommended to use a numeric version for secret + // environment variables as any updates to the secret value is not + // reflected until new instances start. + Version string `json:"version,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Key") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. 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. "Key") 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 *SecretEnvVar) MarshalJSON() ([]byte, error) { + type NoMethod SecretEnvVar + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ServiceConfig: Describes the Service being deployed. Currently // Supported : Cloud Run (fully managed). type ServiceConfig struct { @@ -1687,6 +1733,10 @@ type ServiceConfig struct { // Revision: Output only. The name of service revision. Revision string `json:"revision,omitempty"` + // SecretEnvironmentVariables: Secret environment variables + // configuration. + SecretEnvironmentVariables []*SecretEnvVar `json:"secretEnvironmentVariables,omitempty"` + // Service: Output only. Name of the service associated with a Function. // The format of this field is // `projects/{project}/locations/{region}/services/{service}` @@ -2025,8 +2075,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 @@ -2155,7 +2205,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/cloudidentity/v1beta1/cloudidentity-api.json b/cloudidentity/v1beta1/cloudidentity-api.json index 0e8a0d339ec..d5bfbbf8bb8 100644 --- a/cloudidentity/v1beta1/cloudidentity-api.json +++ b/cloudidentity/v1beta1/cloudidentity-api.json @@ -1536,7 +1536,7 @@ } } }, - "revision": "20220301", + "revision": "20220404", "rootUrl": "https://cloudidentity.googleapis.com/", "schemas": { "AndroidAttributes": { @@ -1933,6 +1933,10 @@ "readOnly": true, "type": "string" }, + "deviceId": { + "description": "Unique identifier for the device.", + "type": "string" + }, "deviceType": { "description": "Output only. Type of device.", "enum": [ diff --git a/cloudidentity/v1beta1/cloudidentity-gen.go b/cloudidentity/v1beta1/cloudidentity-gen.go index 5da8aeefd95..3cb9dd73aaf 100644 --- a/cloudidentity/v1beta1/cloudidentity-gen.go +++ b/cloudidentity/v1beta1/cloudidentity-gen.go @@ -825,6 +825,9 @@ type Device struct { // This field is empty for BYOD devices. CreateTime string `json:"createTime,omitempty"` + // DeviceId: Unique identifier for the device. + DeviceId string `json:"deviceId,omitempty"` + // DeviceType: Output only. Type of device. // // Possible values: diff --git a/cloudiot/v1/cloudiot-api.json b/cloudiot/v1/cloudiot-api.json index 89988ac7c4c..65a9cdbbea7 100644 --- a/cloudiot/v1/cloudiot-api.json +++ b/cloudiot/v1/cloudiot-api.json @@ -938,7 +938,7 @@ } } }, - "revision": "20211108", + "revision": "20220330", "rootUrl": "https://cloudiot.googleapis.com/", "schemas": { "BindDeviceToGatewayRequest": { @@ -1206,7 +1206,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/cloudiot/v1/cloudiot-gen.go b/cloudiot/v1/cloudiot-gen.go index 293ddc5704e..086551f4b8a 100644 --- a/cloudiot/v1/cloudiot-gen.go +++ b/cloudiot/v1/cloudiot-gen.go @@ -720,8 +720,7 @@ func (s *DeviceState) 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. diff --git a/cloudresourcemanager/v1/cloudresourcemanager-api.json b/cloudresourcemanager/v1/cloudresourcemanager-api.json index 573d4b7f574..536ae0ab7b4 100644 --- a/cloudresourcemanager/v1/cloudresourcemanager-api.json +++ b/cloudresourcemanager/v1/cloudresourcemanager-api.json @@ -1171,7 +1171,7 @@ } } }, - "revision": "20220320", + "revision": "20220403", "rootUrl": "https://cloudresourcemanager.googleapis.com/", "schemas": { "Ancestor": { @@ -1242,7 +1242,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" }, @@ -2163,7 +2163,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\"`", @@ -2216,7 +2216,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/cloudresourcemanager/v1/cloudresourcemanager-gen.go b/cloudresourcemanager/v1/cloudresourcemanager-gen.go index e87bbc4b1aa..a37ec81f3a3 100644 --- a/cloudresourcemanager/v1/cloudresourcemanager-gen.go +++ b/cloudresourcemanager/v1/cloudresourcemanager-gen.go @@ -340,8 +340,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 @@ -2217,7 +2217,7 @@ func (s *SearchOrganizationsResponse) 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"` @@ -2327,7 +2327,7 @@ func (s *Status) 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"` diff --git a/cloudresourcemanager/v1beta1/cloudresourcemanager-api.json b/cloudresourcemanager/v1beta1/cloudresourcemanager-api.json index 80359a2d9b4..2e1ba86d4ad 100644 --- a/cloudresourcemanager/v1beta1/cloudresourcemanager-api.json +++ b/cloudresourcemanager/v1beta1/cloudresourcemanager-api.json @@ -566,7 +566,7 @@ } } }, - "revision": "20220320", + "revision": "20220403", "rootUrl": "https://cloudresourcemanager.googleapis.com/", "schemas": { "Ancestor": { @@ -637,7 +637,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" }, @@ -1183,7 +1183,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\"`", @@ -1198,7 +1198,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/cloudresourcemanager/v1beta1/cloudresourcemanager-gen.go b/cloudresourcemanager/v1beta1/cloudresourcemanager-gen.go index c4c3740f8fa..b25e78a2cc0 100644 --- a/cloudresourcemanager/v1beta1/cloudresourcemanager-gen.go +++ b/cloudresourcemanager/v1beta1/cloudresourcemanager-gen.go @@ -304,8 +304,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 @@ -1352,7 +1352,7 @@ func (s *ResourceId) 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"` @@ -1389,7 +1389,7 @@ func (s *SetIamPolicyRequest) 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"` diff --git a/cloudresourcemanager/v2/cloudresourcemanager-api.json b/cloudresourcemanager/v2/cloudresourcemanager-api.json index b71d6c73715..a33e926ab3f 100644 --- a/cloudresourcemanager/v2/cloudresourcemanager-api.json +++ b/cloudresourcemanager/v2/cloudresourcemanager-api.json @@ -450,7 +450,7 @@ } } }, - "revision": "20211107", + "revision": "20220403", "rootUrl": "https://cloudresourcemanager.googleapis.com/", "schemas": { "AuditConfig": { @@ -510,7 +510,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" }, @@ -1017,7 +1017,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\"`", @@ -1059,7 +1059,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/cloudresourcemanager/v2/cloudresourcemanager-gen.go b/cloudresourcemanager/v2/cloudresourcemanager-gen.go index fa137fdf14e..1f2cb1521ac 100644 --- a/cloudresourcemanager/v2/cloudresourcemanager-gen.go +++ b/cloudresourcemanager/v2/cloudresourcemanager-gen.go @@ -276,8 +276,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 @@ -1248,7 +1248,7 @@ func (s *SearchFoldersResponse) 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"` @@ -1329,7 +1329,7 @@ func (s *Status) 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"` diff --git a/cloudresourcemanager/v2beta1/cloudresourcemanager-api.json b/cloudresourcemanager/v2beta1/cloudresourcemanager-api.json index e170a308afb..5c8a6e572cd 100644 --- a/cloudresourcemanager/v2beta1/cloudresourcemanager-api.json +++ b/cloudresourcemanager/v2beta1/cloudresourcemanager-api.json @@ -450,7 +450,7 @@ } } }, - "revision": "20211107", + "revision": "20220403", "rootUrl": "https://cloudresourcemanager.googleapis.com/", "schemas": { "AuditConfig": { @@ -510,7 +510,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" }, @@ -1017,7 +1017,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\"`", @@ -1059,7 +1059,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/cloudresourcemanager/v2beta1/cloudresourcemanager-gen.go b/cloudresourcemanager/v2beta1/cloudresourcemanager-gen.go index 873015532b2..ed0e3a8a212 100644 --- a/cloudresourcemanager/v2beta1/cloudresourcemanager-gen.go +++ b/cloudresourcemanager/v2beta1/cloudresourcemanager-gen.go @@ -276,8 +276,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 @@ -1248,7 +1248,7 @@ func (s *SearchFoldersResponse) 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"` @@ -1329,7 +1329,7 @@ func (s *Status) 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"` diff --git a/cloudresourcemanager/v3/cloudresourcemanager-api.json b/cloudresourcemanager/v3/cloudresourcemanager-api.json index 9111749f236..ea5b07edcd5 100644 --- a/cloudresourcemanager/v3/cloudresourcemanager-api.json +++ b/cloudresourcemanager/v3/cloudresourcemanager-api.json @@ -1609,10 +1609,121 @@ "https://www.googleapis.com/auth/cloud-platform" ] } + }, + "resources": { + "tagHolds": { + "methods": { + "create": { + "description": "Creates a TagHold. Returns ALREADY_EXISTS if a TagHold with the same resource and origin exists under the same TagValue.", + "flatPath": "v3/tagValues/{tagValuesId}/tagHolds", + "httpMethod": "POST", + "id": "cloudresourcemanager.tagValues.tagHolds.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The resource name of the TagHold's parent TagValue. Must be of the form: `tagValues/{tag-value-id}`.", + "location": "path", + "pattern": "^tagValues/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "Optional. Set to true to perform the validations necessary for creating the resource, but not actually perform the action.", + "location": "query", + "type": "boolean" + } + }, + "path": "v3/{+parent}/tagHolds", + "request": { + "$ref": "TagHold" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a TagHold.", + "flatPath": "v3/tagValues/{tagValuesId}/tagHolds/{tagHoldsId}", + "httpMethod": "DELETE", + "id": "cloudresourcemanager.tagValues.tagHolds.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The resource name of the TagHold to delete. Must be of the form: `tagValues/{tag-value-id}/tagHolds/{tag-hold-id}`.", + "location": "path", + "pattern": "^tagValues/[^/]+/tagHolds/[^/]+$", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "Optional. Set to true to perform the validations necessary for deleting the resource, but not actually perform the action.", + "location": "query", + "type": "boolean" + } + }, + "path": "v3/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists TagHolds under a TagValue.", + "flatPath": "v3/tagValues/{tagValuesId}/tagHolds", + "httpMethod": "GET", + "id": "cloudresourcemanager.tagValues.tagHolds.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "Optional. Criteria used to select a subset of TagHolds parented by the TagValue to return. This field follows the syntax defined by aip.dev/160; the `holder` and `origin` fields are supported for filtering. Currently only `AND` syntax is supported. Some example queries are: * `holder = //compute.googleapis.com/compute/projects/myproject/regions/us-east-1/instanceGroupManagers/instance-group` * `origin = 35678234` * `holder = //compute.googleapis.com/compute/projects/myproject/regions/us-east-1/instanceGroupManagers/instance-group AND origin = 35678234`", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "Optional. The maximum number of TagHolds to return in the response. The server allows a maximum of 300 TagHolds to return. If unspecified, the server will use 100 as the default.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. A pagination token returned from a previous call to `ListTagHolds` that indicates where this listing should continue from.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The resource name of the parent TagValue. Must be of the form: `tagValues/{tag-value-id}`.", + "location": "path", + "pattern": "^tagValues/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v3/{+parent}/tagHolds", + "response": { + "$ref": "ListTagHoldsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only" + ] + } + } + } } } }, - "revision": "20220320", + "revision": "20220403", "rootUrl": "https://cloudresourcemanager.googleapis.com/", "schemas": { "AuditConfig": { @@ -1672,7 +1783,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" }, @@ -2125,6 +2236,24 @@ }, "type": "object" }, + "ListTagHoldsResponse": { + "description": "The ListTagHolds response.", + "id": "ListTagHoldsResponse", + "properties": { + "nextPageToken": { + "description": "Pagination token. If the result set is too large to fit in a single response, this token is returned. It encodes the position of the current result cursor. Feeding this value into a new list request with the `page_token` parameter gives the next page of the results. When `next_page_token` is not filled in, there is no next page and the list returned is the last page in the result set. Pagination tokens have a limited lifetime.", + "type": "string" + }, + "tagHolds": { + "description": "A possibly paginated list of TagHolds.", + "items": { + "$ref": "TagHold" + }, + "type": "array" + } + }, + "type": "object" + }, "ListTagKeysResponse": { "description": "The ListTagKeys response message.", "id": "ListTagKeysResponse", @@ -2482,7 +2611,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\"`", @@ -2539,6 +2668,36 @@ }, "type": "object" }, + "TagHold": { + "description": "A TagHold represents the use of a TagValue that is not captured by TagBindings. If a TagValue has any TagHolds, deletion will be blocked. This resource is intended to be created in the same cloud location as the `holder`.", + "id": "TagHold", + "properties": { + "createTime": { + "description": "Output only. The time this TagHold was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "helpLink": { + "description": "Optional. A URL where an end user can learn more about removing this hold. E.g. `https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing`", + "type": "string" + }, + "holder": { + "description": "Required. The name of the resource where the TagValue is being used. Must be less than 200 characters. E.g. `//compute.googleapis.com/compute/projects/myproject/regions/us-east-1/instanceGroupManagers/instance-group`", + "type": "string" + }, + "name": { + "description": "Output only. The resource name of a TagHold. This is a String of the form: `tagValues/{tag-value-id}/tagHolds/{tag-hold-id}` (e.g. `tagValues/123/tagHolds/456`). This resource name is generated by the server.", + "readOnly": true, + "type": "string" + }, + "origin": { + "description": "Optional. An optional string representing the origin of this request. This field should include human-understandable information to distinguish origins from each other. Must be less than 200 characters. E.g. `migs-35678234`", + "type": "string" + } + }, + "type": "object" + }, "TagKey": { "description": "A TagKey, used to group a set of TagValues.", "id": "TagKey", @@ -2632,7 +2791,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/cloudresourcemanager/v3/cloudresourcemanager-gen.go b/cloudresourcemanager/v3/cloudresourcemanager-gen.go index c2978b1cc81..58056e5b96f 100644 --- a/cloudresourcemanager/v3/cloudresourcemanager-gen.go +++ b/cloudresourcemanager/v3/cloudresourcemanager-gen.go @@ -232,11 +232,23 @@ type TagKeysService struct { func NewTagValuesService(s *Service) *TagValuesService { rs := &TagValuesService{s: s} + rs.TagHolds = NewTagValuesTagHoldsService(s) return rs } type TagValuesService struct { s *Service + + TagHolds *TagValuesTagHoldsService +} + +func NewTagValuesTagHoldsService(s *Service) *TagValuesTagHoldsService { + rs := &TagValuesTagHoldsService{s: s} + return rs +} + +type TagValuesTagHoldsService struct { + s *Service } // AuditConfig: Specifies the audit configuration for a service. The @@ -348,8 +360,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 @@ -1149,6 +1161,47 @@ func (s *ListTagBindingsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ListTagHoldsResponse: The ListTagHolds response. +type ListTagHoldsResponse struct { + // NextPageToken: Pagination token. If the result set is too large to + // fit in a single response, this token is returned. It encodes the + // position of the current result cursor. Feeding this value into a new + // list request with the `page_token` parameter gives the next page of + // the results. When `next_page_token` is not filled in, there is no + // next page and the list returned is the last page in the result set. + // Pagination tokens have a limited lifetime. + NextPageToken string `json:"nextPageToken,omitempty"` + + // TagHolds: A possibly paginated list of TagHolds. + TagHolds []*TagHold `json:"tagHolds,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 *ListTagHoldsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListTagHoldsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ListTagKeysResponse: The ListTagKeys response message. type ListTagKeysResponse struct { // NextPageToken: A pagination token returned from a previous call to @@ -1832,7 +1885,7 @@ func (s *SearchProjectsResponse) 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"` @@ -1951,6 +2004,61 @@ func (s *TagBinding) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// TagHold: A TagHold represents the use of a TagValue that is not +// captured by TagBindings. If a TagValue has any TagHolds, deletion +// will be blocked. This resource is intended to be created in the same +// cloud location as the `holder`. +type TagHold struct { + // CreateTime: Output only. The time this TagHold was created. + CreateTime string `json:"createTime,omitempty"` + + // HelpLink: Optional. A URL where an end user can learn more about + // removing this hold. E.g. + // `https://cloud.google.com/resource-manager/docs/tags/tags-creating-and + // -managing` + HelpLink string `json:"helpLink,omitempty"` + + // Holder: Required. The name of the resource where the TagValue is + // being used. Must be less than 200 characters. E.g. + // `//compute.googleapis.com/compute/projects/myproject/regions/us-east-1 + // /instanceGroupManagers/instance-group` + Holder string `json:"holder,omitempty"` + + // Name: Output only. The resource name of a TagHold. This is a String + // of the form: `tagValues/{tag-value-id}/tagHolds/{tag-hold-id}` (e.g. + // `tagValues/123/tagHolds/456`). This resource name is generated by the + // server. + Name string `json:"name,omitempty"` + + // Origin: Optional. An optional string representing the origin of this + // request. This field should include human-understandable information + // to distinguish origins from each other. Must be less than 200 + // characters. E.g. `migs-35678234` + Origin string `json:"origin,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 *TagHold) MarshalJSON() ([]byte, error) { + type NoMethod TagHold + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // TagKey: A TagKey, used to group a set of TagValues. type TagKey struct { // CreateTime: Output only. Creation time. @@ -2085,7 +2193,7 @@ func (s *TagValue) 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"` @@ -10324,3 +10432,523 @@ func (c *TagValuesTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*Tes // } } + +// method id "cloudresourcemanager.tagValues.tagHolds.create": + +type TagValuesTagHoldsCreateCall struct { + s *Service + parent string + taghold *TagHold + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a TagHold. Returns ALREADY_EXISTS if a TagHold with +// the same resource and origin exists under the same TagValue. +// +// - parent: The resource name of the TagHold's parent TagValue. Must be +// of the form: `tagValues/{tag-value-id}`. +func (r *TagValuesTagHoldsService) Create(parent string, taghold *TagHold) *TagValuesTagHoldsCreateCall { + c := &TagValuesTagHoldsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.taghold = taghold + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Set to true +// to perform the validations necessary for creating the resource, but +// not actually perform the action. +func (c *TagValuesTagHoldsCreateCall) ValidateOnly(validateOnly bool) *TagValuesTagHoldsCreateCall { + c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) + 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 *TagValuesTagHoldsCreateCall) Fields(s ...googleapi.Field) *TagValuesTagHoldsCreateCall { + 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 *TagValuesTagHoldsCreateCall) Context(ctx context.Context) *TagValuesTagHoldsCreateCall { + 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 *TagValuesTagHoldsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *TagValuesTagHoldsCreateCall) 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.taghold) + 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, "v3/{+parent}/tagHolds") + 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 "cloudresourcemanager.tagValues.tagHolds.create" call. +// Exactly one of *Operation or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Operation.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 *TagValuesTagHoldsCreateCall) Do(opts ...googleapi.CallOption) (*Operation, 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 := &Operation{ + 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 TagHold. Returns ALREADY_EXISTS if a TagHold with the same resource and origin exists under the same TagValue.", + // "flatPath": "v3/tagValues/{tagValuesId}/tagHolds", + // "httpMethod": "POST", + // "id": "cloudresourcemanager.tagValues.tagHolds.create", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The resource name of the TagHold's parent TagValue. Must be of the form: `tagValues/{tag-value-id}`.", + // "location": "path", + // "pattern": "^tagValues/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "validateOnly": { + // "description": "Optional. Set to true to perform the validations necessary for creating the resource, but not actually perform the action.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v3/{+parent}/tagHolds", + // "request": { + // "$ref": "TagHold" + // }, + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "cloudresourcemanager.tagValues.tagHolds.delete": + +type TagValuesTagHoldsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a TagHold. +// +// - name: The resource name of the TagHold to delete. Must be of the +// form: `tagValues/{tag-value-id}/tagHolds/{tag-hold-id}`. +func (r *TagValuesTagHoldsService) Delete(name string) *TagValuesTagHoldsDeleteCall { + c := &TagValuesTagHoldsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// ValidateOnly sets the optional parameter "validateOnly": Set to true +// to perform the validations necessary for deleting the resource, but +// not actually perform the action. +func (c *TagValuesTagHoldsDeleteCall) ValidateOnly(validateOnly bool) *TagValuesTagHoldsDeleteCall { + c.urlParams_.Set("validateOnly", fmt.Sprint(validateOnly)) + 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 *TagValuesTagHoldsDeleteCall) Fields(s ...googleapi.Field) *TagValuesTagHoldsDeleteCall { + 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 *TagValuesTagHoldsDeleteCall) Context(ctx context.Context) *TagValuesTagHoldsDeleteCall { + 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 *TagValuesTagHoldsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *TagValuesTagHoldsDeleteCall) 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, "v3/{+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 "cloudresourcemanager.tagValues.tagHolds.delete" call. +// Exactly one of *Operation or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Operation.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 *TagValuesTagHoldsDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, 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 := &Operation{ + 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 TagHold.", + // "flatPath": "v3/tagValues/{tagValuesId}/tagHolds/{tagHoldsId}", + // "httpMethod": "DELETE", + // "id": "cloudresourcemanager.tagValues.tagHolds.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The resource name of the TagHold to delete. Must be of the form: `tagValues/{tag-value-id}/tagHolds/{tag-hold-id}`.", + // "location": "path", + // "pattern": "^tagValues/[^/]+/tagHolds/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "validateOnly": { + // "description": "Optional. Set to true to perform the validations necessary for deleting the resource, but not actually perform the action.", + // "location": "query", + // "type": "boolean" + // } + // }, + // "path": "v3/{+name}", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "cloudresourcemanager.tagValues.tagHolds.list": + +type TagValuesTagHoldsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists TagHolds under a TagValue. +// +// - parent: The resource name of the parent TagValue. Must be of the +// form: `tagValues/{tag-value-id}`. +func (r *TagValuesTagHoldsService) List(parent string) *TagValuesTagHoldsListCall { + c := &TagValuesTagHoldsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Filter sets the optional parameter "filter": Criteria used to select +// a subset of TagHolds parented by the TagValue to return. This field +// follows the syntax defined by aip.dev/160; the `holder` and `origin` +// fields are supported for filtering. Currently only `AND` syntax is +// supported. Some example queries are: * `holder = +// //compute.googleapis.com/compute/projects/myproject/regions/us-east-1/ +// instanceGroupManagers/instance-group` * `origin = 35678234` * `holder +// = +// //compute.googleapis.com/compute/projects/myproject/regions/us-east-1/ +// instanceGroupManagers/instance-group AND origin = 35678234` +func (c *TagValuesTagHoldsListCall) Filter(filter string) *TagValuesTagHoldsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number +// of TagHolds to return in the response. The server allows a maximum of +// 300 TagHolds to return. If unspecified, the server will use 100 as +// the default. +func (c *TagValuesTagHoldsListCall) PageSize(pageSize int64) *TagValuesTagHoldsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A pagination token +// returned from a previous call to `ListTagHolds` that indicates where +// this listing should continue from. +func (c *TagValuesTagHoldsListCall) PageToken(pageToken string) *TagValuesTagHoldsListCall { + 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 *TagValuesTagHoldsListCall) Fields(s ...googleapi.Field) *TagValuesTagHoldsListCall { + 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 *TagValuesTagHoldsListCall) IfNoneMatch(entityTag string) *TagValuesTagHoldsListCall { + 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 *TagValuesTagHoldsListCall) Context(ctx context.Context) *TagValuesTagHoldsListCall { + 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 *TagValuesTagHoldsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *TagValuesTagHoldsListCall) 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, "v3/{+parent}/tagHolds") + 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 "cloudresourcemanager.tagValues.tagHolds.list" call. +// Exactly one of *ListTagHoldsResponse or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *ListTagHoldsResponse.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 *TagValuesTagHoldsListCall) Do(opts ...googleapi.CallOption) (*ListTagHoldsResponse, 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 := &ListTagHoldsResponse{ + 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 TagHolds under a TagValue.", + // "flatPath": "v3/tagValues/{tagValuesId}/tagHolds", + // "httpMethod": "GET", + // "id": "cloudresourcemanager.tagValues.tagHolds.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "filter": { + // "description": "Optional. Criteria used to select a subset of TagHolds parented by the TagValue to return. This field follows the syntax defined by aip.dev/160; the `holder` and `origin` fields are supported for filtering. Currently only `AND` syntax is supported. Some example queries are: * `holder = //compute.googleapis.com/compute/projects/myproject/regions/us-east-1/instanceGroupManagers/instance-group` * `origin = 35678234` * `holder = //compute.googleapis.com/compute/projects/myproject/regions/us-east-1/instanceGroupManagers/instance-group AND origin = 35678234`", + // "location": "query", + // "type": "string" + // }, + // "pageSize": { + // "description": "Optional. The maximum number of TagHolds to return in the response. The server allows a maximum of 300 TagHolds to return. If unspecified, the server will use 100 as the default.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "Optional. A pagination token returned from a previous call to `ListTagHolds` that indicates where this listing should continue from.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The resource name of the parent TagValue. Must be of the form: `tagValues/{tag-value-id}`.", + // "location": "path", + // "pattern": "^tagValues/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v3/{+parent}/tagHolds", + // "response": { + // "$ref": "ListTagHoldsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/cloud-platform.read-only" + // ] + // } + +} + +// 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 *TagValuesTagHoldsListCall) Pages(ctx context.Context, f func(*ListTagHoldsResponse) 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) + } +} diff --git a/cloudsearch/v1/cloudsearch-api.json b/cloudsearch/v1/cloudsearch-api.json index 47bcf74ce26..a68665ed4a2 100644 --- a/cloudsearch/v1/cloudsearch-api.json +++ b/cloudsearch/v1/cloudsearch-api.json @@ -136,7 +136,7 @@ "items": { "methods": { "checkAccess": { - "description": "Checks whether an item is accessible by specified principal. **Note:** This API requires an admin account to execute.", + "description": "Checks whether an item is accessible by specified principal. Principal must be a user; groups and domain values aren't supported. **Note:** This API requires an admin account to execute.", "flatPath": "v1/debug/datasources/{datasourcesId}/items/{itemsId}:checkAccess", "httpMethod": "POST", "id": "cloudsearch.debug.datasources.items.checkAccess", @@ -1994,7 +1994,7 @@ } } }, - "revision": "20220322", + "revision": "20220328", "rootUrl": "https://cloudsearch.googleapis.com/", "schemas": { "AclInfo": { diff --git a/cloudsearch/v1/cloudsearch-gen.go b/cloudsearch/v1/cloudsearch-gen.go index 92ee36e648f..2e03d3e0b97 100644 --- a/cloudsearch/v1/cloudsearch-gen.go +++ b/cloudsearch/v1/cloudsearch-gen.go @@ -7690,7 +7690,8 @@ type DebugDatasourcesItemsCheckAccessCall struct { } // CheckAccess: Checks whether an item is accessible by specified -// principal. **Note:** This API requires an admin account to execute. +// principal. Principal must be a user; groups and domain values aren't +// supported. **Note:** This API requires an admin account to execute. // // - name: Item name, format: datasources/{source_id}/items/{item_id}. func (r *DebugDatasourcesItemsService) CheckAccess(name string, principal *Principal) *DebugDatasourcesItemsCheckAccessCall { @@ -7799,7 +7800,7 @@ func (c *DebugDatasourcesItemsCheckAccessCall) Do(opts ...googleapi.CallOption) } return ret, nil // { - // "description": "Checks whether an item is accessible by specified principal. **Note:** This API requires an admin account to execute.", + // "description": "Checks whether an item is accessible by specified principal. Principal must be a user; groups and domain values aren't supported. **Note:** This API requires an admin account to execute.", // "flatPath": "v1/debug/datasources/{datasourcesId}/items/{itemsId}:checkAccess", // "httpMethod": "POST", // "id": "cloudsearch.debug.datasources.items.checkAccess", diff --git a/cloudtrace/v1/cloudtrace-api.json b/cloudtrace/v1/cloudtrace-api.json index 8ba64ea0d95..2dae0f00844 100644 --- a/cloudtrace/v1/cloudtrace-api.json +++ b/cloudtrace/v1/cloudtrace-api.json @@ -257,11 +257,11 @@ } } }, - "revision": "20220224", + "revision": "20220330", "rootUrl": "https://cloudtrace.googleapis.com/", "schemas": { "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/cloudtrace/v1/cloudtrace-gen.go b/cloudtrace/v1/cloudtrace-gen.go index 9a5f85ef234..9a9a3cee76d 100644 --- a/cloudtrace/v1/cloudtrace-gen.go +++ b/cloudtrace/v1/cloudtrace-gen.go @@ -174,8 +174,7 @@ type ProjectsTracesService struct { // 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. diff --git a/cloudtrace/v2/cloudtrace-api.json b/cloudtrace/v2/cloudtrace-api.json index 5def6c78eef..feac8751447 100644 --- a/cloudtrace/v2/cloudtrace-api.json +++ b/cloudtrace/v2/cloudtrace-api.json @@ -181,7 +181,7 @@ } } }, - "revision": "20220224", + "revision": "20220330", "rootUrl": "https://cloudtrace.googleapis.com/", "schemas": { "Annotation": { @@ -253,7 +253,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/cloudtrace/v2/cloudtrace-gen.go b/cloudtrace/v2/cloudtrace-gen.go index 3547f2a12ad..1d22fb1fe16 100644 --- a/cloudtrace/v2/cloudtrace-gen.go +++ b/cloudtrace/v2/cloudtrace-gen.go @@ -319,8 +319,7 @@ func (s *BatchWriteSpansRequest) 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. diff --git a/cloudtrace/v2beta1/cloudtrace-api.json b/cloudtrace/v2beta1/cloudtrace-api.json index 6f83da0726f..fdbb712fa2c 100644 --- a/cloudtrace/v2beta1/cloudtrace-api.json +++ b/cloudtrace/v2beta1/cloudtrace-api.json @@ -273,11 +273,11 @@ } } }, - "revision": "20220224", + "revision": "20220330", "rootUrl": "https://cloudtrace.googleapis.com/", "schemas": { "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/cloudtrace/v2beta1/cloudtrace-gen.go b/cloudtrace/v2beta1/cloudtrace-gen.go index a55088c1c75..67d0ff4335c 100644 --- a/cloudtrace/v2beta1/cloudtrace-gen.go +++ b/cloudtrace/v2beta1/cloudtrace-gen.go @@ -174,8 +174,7 @@ type ProjectsTraceSinksService struct { // 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. diff --git a/content/v2.1/content-api.json b/content/v2.1/content-api.json index 18b6ef6fbac..fd8d9d0910c 100644 --- a/content/v2.1/content-api.json +++ b/content/v2.1/content-api.json @@ -865,6 +865,42 @@ } } }, + "accountsbyexternalsellerid": { + "methods": { + "get": { + "description": "Gets data of the account with the specified external_seller_id belonging to the MCA with the specified merchant_id.", + "flatPath": "{merchantId}/accountsbyexternalsellerid/{externalSellerId}", + "httpMethod": "GET", + "id": "content.accountsbyexternalsellerid.get", + "parameterOrder": [ + "merchantId", + "externalSellerId" + ], + "parameters": { + "externalSellerId": { + "description": "Required. The External Seller ID of the seller account to be retrieved.", + "location": "path", + "required": true, + "type": "string" + }, + "merchantId": { + "description": "Required. The ID of the MCA containing the seller.", + "format": "int64", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "{merchantId}/accountsbyexternalsellerid/{externalSellerId}", + "response": { + "$ref": "Account" + }, + "scopes": [ + "https://www.googleapis.com/auth/content" + ] + } + } + }, "accountstatuses": { "methods": { "custombatch": { @@ -973,6 +1009,48 @@ } } }, + "accountstatusesbyexternalsellerid": { + "methods": { + "get": { + "description": "Gets status of the account with the specified external_seller_id belonging to the MCA with the specified merchant_id.", + "flatPath": "{merchantId}/accountstatusesbyexternalsellerid/{externalSellerId}", + "httpMethod": "GET", + "id": "content.accountstatusesbyexternalsellerid.get", + "parameterOrder": [ + "merchantId", + "externalSellerId" + ], + "parameters": { + "destinations": { + "description": "If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination.", + "location": "query", + "repeated": true, + "type": "string" + }, + "externalSellerId": { + "description": "Required. The External Seller ID of the seller account to be retrieved.", + "location": "path", + "required": true, + "type": "string" + }, + "merchantId": { + "description": "Required. The ID of the MCA containing the seller.", + "format": "int64", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "{merchantId}/accountstatusesbyexternalsellerid/{externalSellerId}", + "response": { + "$ref": "AccountStatus" + }, + "scopes": [ + "https://www.googleapis.com/auth/content" + ] + } + } + }, "accounttax": { "methods": { "custombatch": { @@ -1103,7 +1181,7 @@ "buyongoogleprograms": { "methods": { "activate": { - "description": "Reactivates the BoG program in your Merchant Center account. Moves the program to the active state when allowed, e.g. when paused. Important: This method is only whitelisted for selected merchants.", + "description": "Reactivates the BoG program in your Merchant Center account. Moves the program to the active state when allowed, for example, when paused. This method is only available to selected merchants.", "flatPath": "{merchantId}/buyongoogleprograms/{regionCode}/activate", "httpMethod": "POST", "id": "content.buyongoogleprograms.activate", @@ -1240,7 +1318,7 @@ ] }, "pause": { - "description": "Pauses the BoG program in your Merchant Center account. Important: This method is only whitelisted for selected merchants.", + "description": "Pauses the BoG program in your Merchant Center account. This method is only available to selected merchants.", "flatPath": "{merchantId}/buyongoogleprograms/{regionCode}/pause", "httpMethod": "POST", "id": "content.buyongoogleprograms.pause", @@ -1272,7 +1350,7 @@ ] }, "requestreview": { - "description": "Requests review and then activates the BoG program in your Merchant Center account for the first time. Moves the program to the REVIEW_PENDING state. Important: This method is only whitelisted for selected merchants.", + "description": "Requests review and then activates the BoG program in your Merchant Center account for the first time. Moves the program to the REVIEW_PENDING state. This method is only available to selected merchants.", "flatPath": "{merchantId}/buyongoogleprograms/{regionCode}/requestreview", "httpMethod": "POST", "id": "content.buyongoogleprograms.requestreview", @@ -1962,7 +2040,7 @@ ] }, "requestreview": { - "description": "Requests a review of free listings in a specific region Important: This method is only whitelisted for selected merchants.", + "description": "Requests a review of free listings in a specific region. This method is only available to selected merchants.", "flatPath": "{merchantId}/freelistingsprogram/requestreview", "httpMethod": "POST", "id": "content.freelistingsprogram.requestreview", @@ -5788,7 +5866,7 @@ ] }, "requestreview": { - "description": "Requests a review of Shopping ads in a specific region.", + "description": "Requests a review of Shopping ads in a specific region. This method is only available to selected merchants.", "flatPath": "{merchantId}/shoppingadsprogram/requestreview", "httpMethod": "POST", "id": "content.shoppingadsprogram.requestreview", @@ -5815,7 +5893,7 @@ } } }, - "revision": "20220325", + "revision": "20220331", "rootUrl": "https://shoppingcontent.googleapis.com/", "schemas": { "Account": { diff --git a/content/v2.1/content-gen.go b/content/v2.1/content-gen.go index 5b6ad50e476..f4ee01a9457 100644 --- a/content/v2.1/content-gen.go +++ b/content/v2.1/content-gen.go @@ -118,7 +118,9 @@ func New(client *http.Client) (*APIService, error) { } s := &APIService{client: client, BasePath: basePath} s.Accounts = NewAccountsService(s) + s.Accountsbyexternalsellerid = NewAccountsbyexternalselleridService(s) s.Accountstatuses = NewAccountstatusesService(s) + s.Accountstatusesbyexternalsellerid = NewAccountstatusesbyexternalselleridService(s) s.Accounttax = NewAccounttaxService(s) s.Buyongoogleprograms = NewBuyongoogleprogramsService(s) s.Collections = NewCollectionsService(s) @@ -160,8 +162,12 @@ type APIService struct { Accounts *AccountsService + Accountsbyexternalsellerid *AccountsbyexternalselleridService + Accountstatuses *AccountstatusesService + Accountstatusesbyexternalsellerid *AccountstatusesbyexternalselleridService + Accounttax *AccounttaxService Buyongoogleprograms *BuyongoogleprogramsService @@ -277,6 +283,15 @@ type AccountsReturncarrierService struct { s *APIService } +func NewAccountsbyexternalselleridService(s *APIService) *AccountsbyexternalselleridService { + rs := &AccountsbyexternalselleridService{s: s} + return rs +} + +type AccountsbyexternalselleridService struct { + s *APIService +} + func NewAccountstatusesService(s *APIService) *AccountstatusesService { rs := &AccountstatusesService{s: s} return rs @@ -286,6 +301,15 @@ type AccountstatusesService struct { s *APIService } +func NewAccountstatusesbyexternalselleridService(s *APIService) *AccountstatusesbyexternalselleridService { + rs := &AccountstatusesbyexternalselleridService{s: s} + return rs +} + +type AccountstatusesbyexternalselleridService struct { + s *APIService +} + func NewAccounttaxService(s *APIService) *AccounttaxService { rs := &AccounttaxService{s: s} return rs @@ -21492,6 +21516,165 @@ func (c *AccountsReturncarrierPatchCall) Do(opts ...googleapi.CallOption) (*Acco } +// method id "content.accountsbyexternalsellerid.get": + +type AccountsbyexternalselleridGetCall struct { + s *APIService + merchantId int64 + externalSellerId string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets data of the account with the specified external_seller_id +// belonging to the MCA with the specified merchant_id. +// +// - externalSellerId: The External Seller ID of the seller account to +// be retrieved. +// - merchantId: The ID of the MCA containing the seller. +func (r *AccountsbyexternalselleridService) Get(merchantId int64, externalSellerId string) *AccountsbyexternalselleridGetCall { + c := &AccountsbyexternalselleridGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.merchantId = merchantId + c.externalSellerId = externalSellerId + 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 *AccountsbyexternalselleridGetCall) Fields(s ...googleapi.Field) *AccountsbyexternalselleridGetCall { + 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 *AccountsbyexternalselleridGetCall) IfNoneMatch(entityTag string) *AccountsbyexternalselleridGetCall { + 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 *AccountsbyexternalselleridGetCall) Context(ctx context.Context) *AccountsbyexternalselleridGetCall { + 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 *AccountsbyexternalselleridGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountsbyexternalselleridGetCall) 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, "{merchantId}/accountsbyexternalsellerid/{externalSellerId}") + 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{ + "merchantId": strconv.FormatInt(c.merchantId, 10), + "externalSellerId": c.externalSellerId, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "content.accountsbyexternalsellerid.get" call. +// Exactly one of *Account or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Account.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 *AccountsbyexternalselleridGetCall) Do(opts ...googleapi.CallOption) (*Account, 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 := &Account{ + 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 data of the account with the specified external_seller_id belonging to the MCA with the specified merchant_id.", + // "flatPath": "{merchantId}/accountsbyexternalsellerid/{externalSellerId}", + // "httpMethod": "GET", + // "id": "content.accountsbyexternalsellerid.get", + // "parameterOrder": [ + // "merchantId", + // "externalSellerId" + // ], + // "parameters": { + // "externalSellerId": { + // "description": "Required. The External Seller ID of the seller account to be retrieved.", + // "location": "path", + // "required": true, + // "type": "string" + // }, + // "merchantId": { + // "description": "Required. The ID of the MCA containing the seller.", + // "format": "int64", + // "location": "path", + // "required": true, + // "type": "string" + // } + // }, + // "path": "{merchantId}/accountsbyexternalsellerid/{externalSellerId}", + // "response": { + // "$ref": "Account" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/content" + // ] + // } + +} + // method id "content.accountstatuses.custombatch": type AccountstatusesCustombatchCall struct { @@ -22016,6 +22199,179 @@ func (c *AccountstatusesListCall) Pages(ctx context.Context, f func(*Accountstat } } +// method id "content.accountstatusesbyexternalsellerid.get": + +type AccountstatusesbyexternalselleridGetCall struct { + s *APIService + merchantId int64 + externalSellerId string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets status of the account with the specified external_seller_id +// belonging to the MCA with the specified merchant_id. +// +// - externalSellerId: The External Seller ID of the seller account to +// be retrieved. +// - merchantId: The ID of the MCA containing the seller. +func (r *AccountstatusesbyexternalselleridService) Get(merchantId int64, externalSellerId string) *AccountstatusesbyexternalselleridGetCall { + c := &AccountstatusesbyexternalselleridGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.merchantId = merchantId + c.externalSellerId = externalSellerId + return c +} + +// Destinations sets the optional parameter "destinations": If set, only +// issues for the specified destinations are returned, otherwise only +// issues for the Shopping destination. +func (c *AccountstatusesbyexternalselleridGetCall) Destinations(destinations ...string) *AccountstatusesbyexternalselleridGetCall { + c.urlParams_.SetMulti("destinations", append([]string{}, destinations...)) + 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 *AccountstatusesbyexternalselleridGetCall) Fields(s ...googleapi.Field) *AccountstatusesbyexternalselleridGetCall { + 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 *AccountstatusesbyexternalselleridGetCall) IfNoneMatch(entityTag string) *AccountstatusesbyexternalselleridGetCall { + 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 *AccountstatusesbyexternalselleridGetCall) Context(ctx context.Context) *AccountstatusesbyexternalselleridGetCall { + 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 *AccountstatusesbyexternalselleridGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *AccountstatusesbyexternalselleridGetCall) 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, "{merchantId}/accountstatusesbyexternalsellerid/{externalSellerId}") + 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{ + "merchantId": strconv.FormatInt(c.merchantId, 10), + "externalSellerId": c.externalSellerId, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "content.accountstatusesbyexternalsellerid.get" call. +// Exactly one of *AccountStatus or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *AccountStatus.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 *AccountstatusesbyexternalselleridGetCall) Do(opts ...googleapi.CallOption) (*AccountStatus, 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 := &AccountStatus{ + 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 status of the account with the specified external_seller_id belonging to the MCA with the specified merchant_id.", + // "flatPath": "{merchantId}/accountstatusesbyexternalsellerid/{externalSellerId}", + // "httpMethod": "GET", + // "id": "content.accountstatusesbyexternalsellerid.get", + // "parameterOrder": [ + // "merchantId", + // "externalSellerId" + // ], + // "parameters": { + // "destinations": { + // "description": "If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination.", + // "location": "query", + // "repeated": true, + // "type": "string" + // }, + // "externalSellerId": { + // "description": "Required. The External Seller ID of the seller account to be retrieved.", + // "location": "path", + // "required": true, + // "type": "string" + // }, + // "merchantId": { + // "description": "Required. The ID of the MCA containing the seller.", + // "format": "int64", + // "location": "path", + // "required": true, + // "type": "string" + // } + // }, + // "path": "{merchantId}/accountstatusesbyexternalsellerid/{externalSellerId}", + // "response": { + // "$ref": "AccountStatus" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/content" + // ] + // } + +} + // method id "content.accounttax.custombatch": type AccounttaxCustombatchCall struct { @@ -22670,8 +23026,8 @@ type BuyongoogleprogramsActivateCall struct { } // Activate: Reactivates the BoG program in your Merchant Center -// account. Moves the program to the active state when allowed, e.g. -// when paused. Important: This method is only whitelisted for selected +// account. Moves the program to the active state when allowed, for +// example, when paused. This method is only available to selected // merchants. // // - merchantId: The ID of the account. @@ -22753,7 +23109,7 @@ func (c *BuyongoogleprogramsActivateCall) Do(opts ...googleapi.CallOption) error } return nil // { - // "description": "Reactivates the BoG program in your Merchant Center account. Moves the program to the active state when allowed, e.g. when paused. Important: This method is only whitelisted for selected merchants.", + // "description": "Reactivates the BoG program in your Merchant Center account. Moves the program to the active state when allowed, for example, when paused. This method is only available to selected merchants.", // "flatPath": "{merchantId}/buyongoogleprograms/{regionCode}/activate", // "httpMethod": "POST", // "id": "content.buyongoogleprograms.activate", @@ -23263,8 +23619,8 @@ type BuyongoogleprogramsPauseCall struct { header_ http.Header } -// Pause: Pauses the BoG program in your Merchant Center account. -// Important: This method is only whitelisted for selected merchants. +// Pause: Pauses the BoG program in your Merchant Center account. This +// method is only available to selected merchants. // // - merchantId: The ID of the account. // - regionCode: The program region code ISO 3166-1 alpha-2 @@ -23345,7 +23701,7 @@ func (c *BuyongoogleprogramsPauseCall) Do(opts ...googleapi.CallOption) error { } return nil // { - // "description": "Pauses the BoG program in your Merchant Center account. Important: This method is only whitelisted for selected merchants.", + // "description": "Pauses the BoG program in your Merchant Center account. This method is only available to selected merchants.", // "flatPath": "{merchantId}/buyongoogleprograms/{regionCode}/pause", // "httpMethod": "POST", // "id": "content.buyongoogleprograms.pause", @@ -23393,8 +23749,8 @@ type BuyongoogleprogramsRequestreviewCall struct { // Requestreview: Requests review and then activates the BoG program in // your Merchant Center account for the first time. Moves the program to -// the REVIEW_PENDING state. Important: This method is only whitelisted -// for selected merchants. +// the REVIEW_PENDING state. This method is only available to selected +// merchants. // // - merchantId: The ID of the account. // - regionCode: The program region code ISO 3166-1 alpha-2 @@ -23475,7 +23831,7 @@ func (c *BuyongoogleprogramsRequestreviewCall) Do(opts ...googleapi.CallOption) } return nil // { - // "description": "Requests review and then activates the BoG program in your Merchant Center account for the first time. Moves the program to the REVIEW_PENDING state. Important: This method is only whitelisted for selected merchants.", + // "description": "Requests review and then activates the BoG program in your Merchant Center account for the first time. Moves the program to the REVIEW_PENDING state. This method is only available to selected merchants.", // "flatPath": "{merchantId}/buyongoogleprograms/{regionCode}/requestreview", // "httpMethod": "POST", // "id": "content.buyongoogleprograms.requestreview", @@ -26712,8 +27068,7 @@ type FreelistingsprogramRequestreviewCall struct { } // Requestreview: Requests a review of free listings in a specific -// region Important: This method is only whitelisted for selected -// merchants. +// region. This method is only available to selected merchants. // // - merchantId: The ID of the account. func (r *FreelistingsprogramService) Requestreview(merchantId int64, requestreviewfreelistingsrequest *RequestReviewFreeListingsRequest) *FreelistingsprogramRequestreviewCall { @@ -26789,7 +27144,7 @@ func (c *FreelistingsprogramRequestreviewCall) Do(opts ...googleapi.CallOption) } return nil // { - // "description": "Requests a review of free listings in a specific region Important: This method is only whitelisted for selected merchants.", + // "description": "Requests a review of free listings in a specific region. This method is only available to selected merchants.", // "flatPath": "{merchantId}/freelistingsprogram/requestreview", // "httpMethod": "POST", // "id": "content.freelistingsprogram.requestreview", @@ -44049,7 +44404,7 @@ type ShoppingadsprogramRequestreviewCall struct { } // Requestreview: Requests a review of Shopping ads in a specific -// region. +// region. This method is only available to selected merchants. // // - merchantId: The ID of the account. func (r *ShoppingadsprogramService) Requestreview(merchantId int64, requestreviewshoppingadsrequest *RequestReviewShoppingAdsRequest) *ShoppingadsprogramRequestreviewCall { @@ -44125,7 +44480,7 @@ func (c *ShoppingadsprogramRequestreviewCall) Do(opts ...googleapi.CallOption) e } return nil // { - // "description": "Requests a review of Shopping ads in a specific region.", + // "description": "Requests a review of Shopping ads in a specific region. This method is only available to selected merchants.", // "flatPath": "{merchantId}/shoppingadsprogram/requestreview", // "httpMethod": "POST", // "id": "content.shoppingadsprogram.requestreview", diff --git a/dataplex/v1/dataplex-api.json b/dataplex/v1/dataplex-api.json index 76433ca9a51..38340222c8d 100644 --- a/dataplex/v1/dataplex-api.json +++ b/dataplex/v1/dataplex-api.json @@ -2494,11 +2494,11 @@ } } }, - "revision": "20220223", + "revision": "20220328", "rootUrl": "https://dataplex.googleapis.com/", "schemas": { "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" @@ -3287,6 +3287,13 @@ "description": "The name to the partition resource. The name is the fully-qualified resource name.", "type": "string" }, + "sampledDataLocations": { + "description": "The locations of the data items (e.g., a Cloud Storage objects) sampled for metadata inference.", + "items": { + "type": "string" + }, + "type": "array" + }, "type": { "description": "The type of the containing entity resource.", "enum": [ diff --git a/dataplex/v1/dataplex-gen.go b/dataplex/v1/dataplex-gen.go index ee136693318..8326788d023 100644 --- a/dataplex/v1/dataplex-gen.go +++ b/dataplex/v1/dataplex-gen.go @@ -342,8 +342,7 @@ type ProjectsLocationsOperationsService struct { // 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. @@ -1444,6 +1443,10 @@ type GoogleCloudDataplexV1DiscoveryEventPartitionDetails struct { // fully-qualified resource name. Partition string `json:"partition,omitempty"` + // SampledDataLocations: The locations of the data items (e.g., a Cloud + // Storage objects) sampled for metadata inference. + SampledDataLocations []string `json:"sampledDataLocations,omitempty"` + // Type: The type of the containing entity resource. // // Possible values: diff --git a/datastore/v1/datastore-api.json b/datastore/v1/datastore-api.json index 0a3e28ccace..0a81f3cb671 100644 --- a/datastore/v1/datastore-api.json +++ b/datastore/v1/datastore-api.json @@ -626,7 +626,7 @@ } } }, - "revision": "20220319", + "revision": "20220402", "rootUrl": "https://datastore.googleapis.com/", "schemas": { "AllocateIdsRequest": { @@ -731,6 +731,11 @@ "description": "The response for Datastore.Commit.", "id": "CommitResponse", "properties": { + "commitTime": { + "description": "The transaction commit timestamp. Not set for non-transactional commits.", + "format": "google-datetime", + "type": "string" + }, "indexUpdates": { "description": "The number of index entries updated during the commit, or zero if none were updated.", "format": "int32", @@ -809,6 +814,11 @@ "$ref": "Entity", "description": "The resulting entity." }, + "updateTime": { + "description": "The time at which the entity was last changed. This field is set for `FULL` entity results. If this entity is missing, this field will not be set.", + "format": "google-datetime", + "type": "string" + }, "version": { "description": "The version of the entity, a strictly positive number that monotonically increases with changes to the entity. This field is set for `FULL` entity results. For missing entities in `LookupResponse`, this is the version of the snapshot that was used to look up the entity, and it is always set except for eventually consistent reads.", "format": "int64", @@ -1674,6 +1684,11 @@ "$ref": "EntityResult" }, "type": "array" + }, + "readTime": { + "description": "The time at which these entities were read or found missing.", + "format": "google-datetime", + "type": "string" } }, "type": "object" @@ -1699,6 +1714,11 @@ "$ref": "Entity", "description": "The entity to update. The entity must already exist. Must have a complete key path." }, + "updateTime": { + "description": "The update time of the entity that this mutation is being applied to. If this does not match the current update time on the server, the mutation conflicts.", + "format": "google-datetime", + "type": "string" + }, "upsert": { "$ref": "Entity", "description": "The entity to upsert. The entity may or may not already exist. The entity key's final path element may be incomplete." @@ -1718,6 +1738,11 @@ "$ref": "Key", "description": "The automatically allocated key. Set only when the mutation allocated a key." }, + "updateTime": { + "description": "The update time of the entity on the server after processing the mutation. If the mutation doesn't change anything on the server, then the timestamp will be the update timestamp of the current entity. This field will not be set after a 'delete'.", + "format": "google-datetime", + "type": "string" + }, "version": { "description": "The version of the entity on the server after processing the mutation. If the mutation doesn't change anything on the server, then the version will be the version of the current entity or, if no entity is present, a version that is strictly greater than the version of any previous entity and less than the version of any possible future entity.", "format": "int64", @@ -1960,6 +1985,11 @@ ], "type": "string" }, + "readTime": { + "description": "Read timestamp this batch was returned from. This applies to the range of results from the query's `start_cursor` (or the beginning of the query if no cursor was given) to this batch's `end_cursor` (not the query's `end_cursor`). In a single transaction, subsequent query result batches for the same query can have a greater timestamp. Each batch's read timestamp is valid for all preceding batches. This value will not be set for eventually consistent queries in Cloud Datastore.", + "format": "google-datetime", + "type": "string" + }, "skippedCursor": { "description": "A cursor that points to the position after the last skipped result. Will be set when `skipped_results` != 0.", "format": "byte", @@ -1981,7 +2011,13 @@ "ReadOnly": { "description": "Options specific to read-only transactions.", "id": "ReadOnly", - "properties": {}, + "properties": { + "readTime": { + "description": "Reads entities at the given time. This may not be older than 60 seconds.", + "format": "google-datetime", + "type": "string" + } + }, "type": "object" }, "ReadOptions": { @@ -2002,6 +2038,11 @@ ], "type": "string" }, + "readTime": { + "description": "Reads entities as they were at the given time. This may not be older than 270 seconds. This value is only supported for Cloud Firestore in Datastore mode.", + "format": "google-datetime", + "type": "string" + }, "transaction": { "description": "The identifier of the transaction in which to read. A transaction identifier is returned by a call to Datastore.BeginTransaction.", "format": "byte", diff --git a/datastore/v1/datastore-gen.go b/datastore/v1/datastore-gen.go index d4d32db2126..c8c7b3d4900 100644 --- a/datastore/v1/datastore-gen.go +++ b/datastore/v1/datastore-gen.go @@ -386,6 +386,10 @@ func (s *CommitRequest) MarshalJSON() ([]byte, error) { // CommitResponse: The response for Datastore.Commit. type CommitResponse struct { + // CommitTime: The transaction commit timestamp. Not set for + // non-transactional commits. + CommitTime string `json:"commitTime,omitempty"` + // IndexUpdates: The number of index entries updated during the commit, // or zero if none were updated. IndexUpdates int64 `json:"indexUpdates,omitempty"` @@ -398,7 +402,7 @@ type CommitResponse struct { // server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "IndexUpdates") to + // ForceSendFields is a list of field names (e.g. "CommitTime") 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 @@ -406,10 +410,10 @@ type CommitResponse struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "IndexUpdates") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as + // NullFields is a list of field names (e.g. "CommitTime") 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:"-"` @@ -520,6 +524,11 @@ type EntityResult struct { // Entity: The resulting entity. Entity *Entity `json:"entity,omitempty"` + // UpdateTime: The time at which the entity was last changed. This field + // is set for `FULL` entity results. If this entity is missing, this + // field will not be set. + UpdateTime string `json:"updateTime,omitempty"` + // Version: The version of the entity, a strictly positive number that // monotonically increases with changes to the entity. This field is set // for `FULL` entity results. For missing entities in `LookupResponse`, @@ -1977,6 +1986,10 @@ type LookupResponse struct { // the order of the keys in the input. Missing []*EntityResult `json:"missing,omitempty"` + // ReadTime: The time at which these entities were read or found + // missing. + ReadTime string `json:"readTime,omitempty"` + // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` @@ -2024,6 +2037,11 @@ type Mutation struct { // have a complete key path. Update *Entity `json:"update,omitempty"` + // UpdateTime: The update time of the entity that this mutation is being + // applied to. If this does not match the current update time on the + // server, the mutation conflicts. + UpdateTime string `json:"updateTime,omitempty"` + // Upsert: The entity to upsert. The entity may or may not already // exist. The entity key's final path element may be incomplete. Upsert *Entity `json:"upsert,omitempty"` @@ -2062,6 +2080,12 @@ type MutationResult struct { // allocated a key. Key *Key `json:"key,omitempty"` + // UpdateTime: The update time of the entity on the server after + // processing the mutation. If the mutation doesn't change anything on + // the server, then the timestamp will be the update timestamp of the + // current entity. This field will not be set after a 'delete'. + UpdateTime string `json:"updateTime,omitempty"` + // Version: The version of the entity on the server after processing the // mutation. If the mutation doesn't change anything on the server, then // the version will be the version of the current entity or, if no @@ -2434,6 +2458,16 @@ type QueryResultBatch struct { // results. MoreResults string `json:"moreResults,omitempty"` + // ReadTime: Read timestamp this batch was returned from. This applies + // to the range of results from the query's `start_cursor` (or the + // beginning of the query if no cursor was given) to this batch's + // `end_cursor` (not the query's `end_cursor`). In a single transaction, + // subsequent query result batches for the same query can have a greater + // timestamp. Each batch's read timestamp is valid for all preceding + // batches. This value will not be set for eventually consistent queries + // in Cloud Datastore. + ReadTime string `json:"readTime,omitempty"` + // SkippedCursor: A cursor that points to the position after the last // skipped result. Will be set when `skipped_results` != 0. SkippedCursor string `json:"skippedCursor,omitempty"` @@ -2477,6 +2511,31 @@ func (s *QueryResultBatch) MarshalJSON() ([]byte, error) { // ReadOnly: Options specific to read-only transactions. type ReadOnly struct { + // ReadTime: Reads entities at the given time. This may not be older + // than 60 seconds. + ReadTime string `json:"readTime,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ReadTime") 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. "ReadTime") 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 *ReadOnly) MarshalJSON() ([]byte, error) { + type NoMethod ReadOnly + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // ReadOptions: The options shared by read requests. @@ -2491,6 +2550,11 @@ type ReadOptions struct { // "EVENTUAL" - Eventual consistency. ReadConsistency string `json:"readConsistency,omitempty"` + // ReadTime: Reads entities as they were at the given time. This may not + // be older than 270 seconds. This value is only supported for Cloud + // Firestore in Datastore mode. + ReadTime string `json:"readTime,omitempty"` + // Transaction: The identifier of the transaction in which to read. A // transaction identifier is returned by a call to // Datastore.BeginTransaction. diff --git a/datastore/v1beta3/datastore-api.json b/datastore/v1beta3/datastore-api.json index ccd9fd165db..3be574aaef9 100644 --- a/datastore/v1beta3/datastore-api.json +++ b/datastore/v1beta3/datastore-api.json @@ -308,7 +308,7 @@ } } }, - "revision": "20220319", + "revision": "20220402", "rootUrl": "https://datastore.googleapis.com/", "schemas": { "AllocateIdsRequest": { @@ -413,6 +413,11 @@ "description": "The response for Datastore.Commit.", "id": "CommitResponse", "properties": { + "commitTime": { + "description": "The transaction commit timestamp. Not set for non-transactional commits.", + "format": "google-datetime", + "type": "string" + }, "indexUpdates": { "description": "The number of index entries updated during the commit, or zero if none were updated.", "format": "int32", @@ -485,6 +490,11 @@ "$ref": "Entity", "description": "The resulting entity." }, + "updateTime": { + "description": "The time at which the entity was last changed. This field is set for `FULL` entity results. If this entity is missing, this field will not be set.", + "format": "google-datetime", + "type": "string" + }, "version": { "description": "The version of the entity, a strictly positive number that monotonically increases with changes to the entity. This field is set for `FULL` entity results. For missing entities in `LookupResponse`, this is the version of the snapshot that was used to look up the entity, and it is always set except for eventually consistent reads.", "format": "int64", @@ -1149,6 +1159,11 @@ "$ref": "EntityResult" }, "type": "array" + }, + "readTime": { + "description": "The time at which these entities were read or found missing.", + "format": "google-datetime", + "type": "string" } }, "type": "object" @@ -1174,6 +1189,11 @@ "$ref": "Entity", "description": "The entity to update. The entity must already exist. Must have a complete key path." }, + "updateTime": { + "description": "The update time of the entity that this mutation is being applied to. If this does not match the current update time on the server, the mutation conflicts.", + "format": "google-datetime", + "type": "string" + }, "upsert": { "$ref": "Entity", "description": "The entity to upsert. The entity may or may not already exist. The entity key's final path element may be incomplete." @@ -1193,6 +1213,11 @@ "$ref": "Key", "description": "The automatically allocated key. Set only when the mutation allocated a key." }, + "updateTime": { + "description": "The update time of the entity on the server after processing the mutation. If the mutation doesn't change anything on the server, then the timestamp will be the update timestamp of the current entity. This field will not be set after a 'delete'.", + "format": "google-datetime", + "type": "string" + }, "version": { "description": "The version of the entity on the server after processing the mutation. If the mutation doesn't change anything on the server, then the version will be the version of the current entity or, if no entity is present, a version that is strictly greater than the version of any previous entity and less than the version of any possible future entity.", "format": "int64", @@ -1435,6 +1460,11 @@ ], "type": "string" }, + "readTime": { + "description": "Read timestamp this batch was returned from. This applies to the range of results from the query's `start_cursor` (or the beginning of the query if no cursor was given) to this batch's `end_cursor` (not the query's `end_cursor`). In a single transaction, subsequent query result batches for the same query can have a greater timestamp. Each batch's read timestamp is valid for all preceding batches. This value will not be set for eventually consistent queries in Cloud Datastore.", + "format": "google-datetime", + "type": "string" + }, "skippedCursor": { "description": "A cursor that points to the position after the last skipped result. Will be set when `skipped_results` != 0.", "format": "byte", @@ -1456,7 +1486,13 @@ "ReadOnly": { "description": "Options specific to read-only transactions.", "id": "ReadOnly", - "properties": {}, + "properties": { + "readTime": { + "description": "Reads entities at the given time. This may not be older than 60 seconds.", + "format": "google-datetime", + "type": "string" + } + }, "type": "object" }, "ReadOptions": { @@ -1477,6 +1513,11 @@ ], "type": "string" }, + "readTime": { + "description": "Reads entities as they were at the given time. This may not be older than 270 seconds. This value is only supported for Cloud Firestore in Datastore mode.", + "format": "google-datetime", + "type": "string" + }, "transaction": { "description": "The identifier of the transaction in which to read. A transaction identifier is returned by a call to Datastore.BeginTransaction.", "format": "byte", diff --git a/datastore/v1beta3/datastore-gen.go b/datastore/v1beta3/datastore-gen.go index 3a5347f3425..94eafd1063f 100644 --- a/datastore/v1beta3/datastore-gen.go +++ b/datastore/v1beta3/datastore-gen.go @@ -362,6 +362,10 @@ func (s *CommitRequest) MarshalJSON() ([]byte, error) { // CommitResponse: The response for Datastore.Commit. type CommitResponse struct { + // CommitTime: The transaction commit timestamp. Not set for + // non-transactional commits. + CommitTime string `json:"commitTime,omitempty"` + // IndexUpdates: The number of index entries updated during the commit, // or zero if none were updated. IndexUpdates int64 `json:"indexUpdates,omitempty"` @@ -374,7 +378,7 @@ type CommitResponse struct { // server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "IndexUpdates") to + // ForceSendFields is a list of field names (e.g. "CommitTime") 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 @@ -382,10 +386,10 @@ type CommitResponse struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "IndexUpdates") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as + // NullFields is a list of field names (e.g. "CommitTime") 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:"-"` @@ -485,6 +489,11 @@ type EntityResult struct { // Entity: The resulting entity. Entity *Entity `json:"entity,omitempty"` + // UpdateTime: The time at which the entity was last changed. This field + // is set for `FULL` entity results. If this entity is missing, this + // field will not be set. + UpdateTime string `json:"updateTime,omitempty"` + // Version: The version of the entity, a strictly positive number that // monotonically increases with changes to the entity. This field is set // for `FULL` entity results. For missing entities in `LookupResponse`, @@ -1594,6 +1603,10 @@ type LookupResponse struct { // the order of the keys in the input. Missing []*EntityResult `json:"missing,omitempty"` + // ReadTime: The time at which these entities were read or found + // missing. + ReadTime string `json:"readTime,omitempty"` + // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` @@ -1641,6 +1654,11 @@ type Mutation struct { // have a complete key path. Update *Entity `json:"update,omitempty"` + // UpdateTime: The update time of the entity that this mutation is being + // applied to. If this does not match the current update time on the + // server, the mutation conflicts. + UpdateTime string `json:"updateTime,omitempty"` + // Upsert: The entity to upsert. The entity may or may not already // exist. The entity key's final path element may be incomplete. Upsert *Entity `json:"upsert,omitempty"` @@ -1679,6 +1697,12 @@ type MutationResult struct { // allocated a key. Key *Key `json:"key,omitempty"` + // UpdateTime: The update time of the entity on the server after + // processing the mutation. If the mutation doesn't change anything on + // the server, then the timestamp will be the update timestamp of the + // current entity. This field will not be set after a 'delete'. + UpdateTime string `json:"updateTime,omitempty"` + // Version: The version of the entity on the server after processing the // mutation. If the mutation doesn't change anything on the server, then // the version will be the version of the current entity or, if no @@ -2051,6 +2075,16 @@ type QueryResultBatch struct { // results. MoreResults string `json:"moreResults,omitempty"` + // ReadTime: Read timestamp this batch was returned from. This applies + // to the range of results from the query's `start_cursor` (or the + // beginning of the query if no cursor was given) to this batch's + // `end_cursor` (not the query's `end_cursor`). In a single transaction, + // subsequent query result batches for the same query can have a greater + // timestamp. Each batch's read timestamp is valid for all preceding + // batches. This value will not be set for eventually consistent queries + // in Cloud Datastore. + ReadTime string `json:"readTime,omitempty"` + // SkippedCursor: A cursor that points to the position after the last // skipped result. Will be set when `skipped_results` != 0. SkippedCursor string `json:"skippedCursor,omitempty"` @@ -2094,6 +2128,31 @@ func (s *QueryResultBatch) MarshalJSON() ([]byte, error) { // ReadOnly: Options specific to read-only transactions. type ReadOnly struct { + // ReadTime: Reads entities at the given time. This may not be older + // than 60 seconds. + ReadTime string `json:"readTime,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ReadTime") 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. "ReadTime") 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 *ReadOnly) MarshalJSON() ([]byte, error) { + type NoMethod ReadOnly + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // ReadOptions: The options shared by read requests. @@ -2108,6 +2167,11 @@ type ReadOptions struct { // "EVENTUAL" - Eventual consistency. ReadConsistency string `json:"readConsistency,omitempty"` + // ReadTime: Reads entities as they were at the given time. This may not + // be older than 270 seconds. This value is only supported for Cloud + // Firestore in Datastore mode. + ReadTime string `json:"readTime,omitempty"` + // Transaction: The identifier of the transaction in which to read. A // transaction identifier is returned by a call to // Datastore.BeginTransaction. diff --git a/dialogflow/v2/dialogflow-api.json b/dialogflow/v2/dialogflow-api.json index 1f22844bc0c..5c657774212 100644 --- a/dialogflow/v2/dialogflow-api.json +++ b/dialogflow/v2/dialogflow-api.json @@ -4186,7 +4186,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" }, @@ -8077,7 +8077,7 @@ } } }, - "revision": "20220330", + "revision": "20220404", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AudioInput": { diff --git a/dialogflow/v2/dialogflow-gen.go b/dialogflow/v2/dialogflow-gen.go index bd59f3e2745..fa4796f8968 100644 --- a/dialogflow/v2/dialogflow-gen.go +++ b/dialogflow/v2/dialogflow-gen.go @@ -40460,8 +40460,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 @@ -40592,7 +40592,7 @@ func (c *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*GoogleClo // ], // "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/dialogflow/v2beta1/dialogflow-api.json b/dialogflow/v2beta1/dialogflow-api.json index 8219681c70f..94337bc677e 100644 --- a/dialogflow/v2beta1/dialogflow-api.json +++ b/dialogflow/v2beta1/dialogflow-api.json @@ -3943,7 +3943,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" }, @@ -7431,7 +7431,7 @@ } } }, - "revision": "20220330", + "revision": "20220404", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AudioInput": { diff --git a/dialogflow/v2beta1/dialogflow-gen.go b/dialogflow/v2beta1/dialogflow-gen.go index 75b1575c0c1..5d87747c7b1 100644 --- a/dialogflow/v2beta1/dialogflow-gen.go +++ b/dialogflow/v2beta1/dialogflow-gen.go @@ -39482,8 +39482,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 @@ -39614,7 +39614,7 @@ func (c *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*GoogleClo // ], // "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/dialogflow/v3/dialogflow-api.json b/dialogflow/v3/dialogflow-api.json index fd51adb098e..e5679e9a9cf 100644 --- a/dialogflow/v3/dialogflow-api.json +++ b/dialogflow/v3/dialogflow-api.json @@ -148,7 +148,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" }, @@ -3820,7 +3820,7 @@ } } }, - "revision": "20220330", + "revision": "20220404", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { diff --git a/dialogflow/v3/dialogflow-gen.go b/dialogflow/v3/dialogflow-gen.go index 49fd46e61e6..dff90fe6928 100644 --- a/dialogflow/v3/dialogflow-gen.go +++ b/dialogflow/v3/dialogflow-gen.go @@ -19274,8 +19274,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 @@ -19406,7 +19406,7 @@ func (c *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*GoogleClo // ], // "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/dialogflow/v3beta1/dialogflow-api.json b/dialogflow/v3beta1/dialogflow-api.json index 4df2247dce0..745ca0c4c5c 100644 --- a/dialogflow/v3beta1/dialogflow-api.json +++ b/dialogflow/v3beta1/dialogflow-api.json @@ -148,7 +148,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" }, @@ -3820,7 +3820,7 @@ } } }, - "revision": "20220330", + "revision": "20220404", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AudioInput": { diff --git a/dialogflow/v3beta1/dialogflow-gen.go b/dialogflow/v3beta1/dialogflow-gen.go index 44f1045e46e..3b4c344bd7c 100644 --- a/dialogflow/v3beta1/dialogflow-gen.go +++ b/dialogflow/v3beta1/dialogflow-gen.go @@ -19279,8 +19279,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 @@ -19411,7 +19411,7 @@ func (c *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*GoogleClo // ], // "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/docs/v1/docs-api.json b/docs/v1/docs-api.json index 0c395651a58..2a8c8ed4b15 100644 --- a/docs/v1/docs-api.json +++ b/docs/v1/docs-api.json @@ -216,7 +216,7 @@ } } }, - "revision": "20220325", + "revision": "20220331", "rootUrl": "https://docs.googleapis.com/", "schemas": { "AutoText": { @@ -1459,7 +1459,7 @@ "description": "The properties of this inline object." }, "objectId": { - "description": "The ID of this inline object.", + "description": "The ID of this inline object. Can be used to update an object’s properties.", "type": "string" }, "suggestedDeletionIds": { @@ -2764,7 +2764,7 @@ "id": "ReplaceImageRequest", "properties": { "imageObjectId": { - "description": "The ID of the existing image that will be replaced.", + "description": "The ID of the existing image that will be replaced. The ID can be retrieved from the response of a get request.", "type": "string" }, "imageReplaceMethod": { @@ -2775,12 +2775,12 @@ ], "enumDescriptions": [ "Unspecified image replace method. This value must not be used.", - "Scales and centers the image to fill the bounds of the original image. The image may be cropped in order to fill the original image's bounds. The rendered size of the image will be the same as that of the original image." + "Scales and centers the image to fill the bounds of the original image. The image may be cropped in order to fill the original image's bounds. The rendered size of the image will be the same as the original image." ], "type": "string" }, "uri": { - "description": "The URI of the new image. The image is fetched once at insertion time and a copy is stored for display inside the document. Images must be less than 50MB in size, cannot exceed 25 megapixels, and must be in one of PNG, JPEG, or GIF format. The provided URI can be at most 2 kB in length. The URI itself is saved with the image, and exposed via the ImageProperties.source_uri field.", + "description": "The URI of the new image. The image is fetched once at insertion time and a copy is stored for display inside the document. Images must be less than 50MB, cannot exceed 25 megapixels, and must be in PNG, JPEG, or GIF format. The provided URI can't surpass 2 KB in length. The URI is saved with the image, and exposed through the ImageProperties.source_uri field.", "type": "string" } }, diff --git a/docs/v1/docs-gen.go b/docs/v1/docs-gen.go index 0cb0e2ff051..fb38cdcabc0 100644 --- a/docs/v1/docs-gen.go +++ b/docs/v1/docs-gen.go @@ -2313,7 +2313,8 @@ type InlineObject struct { // InlineObjectProperties: The properties of this inline object. InlineObjectProperties *InlineObjectProperties `json:"inlineObjectProperties,omitempty"` - // ObjectId: The ID of this inline object. + // ObjectId: The ID of this inline object. Can be used to update an + // object’s properties. ObjectId string `json:"objectId,omitempty"` // SuggestedDeletionIds: The suggested deletion IDs. If empty, then @@ -4527,6 +4528,7 @@ func (s *ReplaceAllTextResponse) MarshalJSON() ([]byte, error) { // in order to mirror the behavior of the Docs editor. type ReplaceImageRequest struct { // ImageObjectId: The ID of the existing image that will be replaced. + // The ID can be retrieved from the response of a get request. ImageObjectId string `json:"imageObjectId,omitempty"` // ImageReplaceMethod: The replacement method. @@ -4537,15 +4539,15 @@ type ReplaceImageRequest struct { // "CENTER_CROP" - Scales and centers the image to fill the bounds of // the original image. The image may be cropped in order to fill the // original image's bounds. The rendered size of the image will be the - // same as that of the original image. + // same as the original image. ImageReplaceMethod string `json:"imageReplaceMethod,omitempty"` // Uri: The URI of the new image. The image is fetched once at insertion // time and a copy is stored for display inside the document. Images - // must be less than 50MB in size, cannot exceed 25 megapixels, and must - // be in one of PNG, JPEG, or GIF format. The provided URI can be at - // most 2 kB in length. The URI itself is saved with the image, and - // exposed via the ImageProperties.source_uri field. + // must be less than 50MB, cannot exceed 25 megapixels, and must be in + // PNG, JPEG, or GIF format. The provided URI can't surpass 2 KB in + // length. The URI is saved with the image, and exposed through the + // ImageProperties.source_uri field. Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "ImageObjectId") to diff --git a/doubleclickbidmanager/v1.1/doubleclickbidmanager-api.json b/doubleclickbidmanager/v1.1/doubleclickbidmanager-api.json index eb66d873f8e..0846e6bbf8a 100644 --- a/doubleclickbidmanager/v1.1/doubleclickbidmanager-api.json +++ b/doubleclickbidmanager/v1.1/doubleclickbidmanager-api.json @@ -280,7 +280,7 @@ } } }, - "revision": "20211109", + "revision": "20220329", "rootUrl": "https://doubleclickbidmanager.googleapis.com/", "schemas": { "ChannelGrouping": { @@ -1986,7 +1986,6 @@ "METRIC_INVALID_CLICKS", "METRIC_INVALID_IMPRESSIONS", "METRIC_INVALID_TRACKED_ADS", - "METRIC_MEDIA_COST_ADVERTISER_CURRENCY_PER_STORE_VISIT_ADX_ONLY", "METRIC_MIDPOINT_AUDIO", "METRIC_ORIGINAL_AUDIENCE_FREQUENCY", "METRIC_PAUSES_AUDIO", @@ -2002,11 +2001,9 @@ "METRIC_REFUND_BILLABLE_COST_ADVERTISER_CURRENCY", "METRIC_REFUND_MEDIA_COST_ADVERTISER_CURRENCY", "METRIC_REFUND_PLATFORM_FEE_ADVERTISER_CURRENCY", - "METRIC_REVENUE_ADVERTISER_CURRENCY_PER_STORE_VISIT_ADX_ONLY", "METRIC_RICH_MEDIA_ENGAGEMENTS", "METRIC_STARTS_AUDIO", "METRIC_STOPS_AUDIO", - "METRIC_STORE_VISITS_ADX_ONLY", "METRIC_STORE_VISIT_CONVERSIONS", "METRIC_THIRD_QUARTILE_AUDIO", "METRIC_TIMERS", @@ -2015,7 +2012,6 @@ "METRIC_TOTAL_DISPLAY_TIME", "METRIC_TOTAL_IMPRESSION_CUSTOM_VALUE", "METRIC_TOTAL_INTERACTION_TIME", - "METRIC_TOTAL_MEDIA_COST_ADVERTISER_CURRENCY_PER_STORE_VISIT_ADX_ONLY", "METRIC_TOTAL_USERS", "METRIC_TRACKED_ADS", "METRIC_TRUEVIEW_GENERAL_INVALID_TRAFFIC_GIVT_VIEWS", @@ -2541,10 +2537,6 @@ "", "", "", - "", - "", - "", - "", "" ], "type": "string" diff --git a/doubleclickbidmanager/v1.1/doubleclickbidmanager-gen.go b/doubleclickbidmanager/v1.1/doubleclickbidmanager-gen.go index fa62df75c79..a9e1cd32afb 100644 --- a/doubleclickbidmanager/v1.1/doubleclickbidmanager-gen.go +++ b/doubleclickbidmanager/v1.1/doubleclickbidmanager-gen.go @@ -1403,7 +1403,6 @@ type Parameters struct { // "METRIC_INVALID_CLICKS" // "METRIC_INVALID_IMPRESSIONS" // "METRIC_INVALID_TRACKED_ADS" - // "METRIC_MEDIA_COST_ADVERTISER_CURRENCY_PER_STORE_VISIT_ADX_ONLY" // "METRIC_MIDPOINT_AUDIO" // "METRIC_ORIGINAL_AUDIENCE_FREQUENCY" // "METRIC_PAUSES_AUDIO" @@ -1422,11 +1421,9 @@ type Parameters struct { // "METRIC_REFUND_BILLABLE_COST_ADVERTISER_CURRENCY" // "METRIC_REFUND_MEDIA_COST_ADVERTISER_CURRENCY" // "METRIC_REFUND_PLATFORM_FEE_ADVERTISER_CURRENCY" - // "METRIC_REVENUE_ADVERTISER_CURRENCY_PER_STORE_VISIT_ADX_ONLY" // "METRIC_RICH_MEDIA_ENGAGEMENTS" // "METRIC_STARTS_AUDIO" // "METRIC_STOPS_AUDIO" - // "METRIC_STORE_VISITS_ADX_ONLY" // "METRIC_STORE_VISIT_CONVERSIONS" // "METRIC_THIRD_QUARTILE_AUDIO" // "METRIC_TIMERS" @@ -1435,8 +1432,6 @@ type Parameters struct { // "METRIC_TOTAL_DISPLAY_TIME" // "METRIC_TOTAL_IMPRESSION_CUSTOM_VALUE" // "METRIC_TOTAL_INTERACTION_TIME" - // - // "METRIC_TOTAL_MEDIA_COST_ADVERTISER_CURRENCY_PER_STORE_VISIT_ADX_ONLY" // "METRIC_TOTAL_USERS" // "METRIC_TRACKED_ADS" // "METRIC_TRUEVIEW_GENERAL_INVALID_TRAFFIC_GIVT_VIEWS" diff --git a/eventarc/v1/eventarc-api.json b/eventarc/v1/eventarc-api.json index 6b85e39b13e..c3efdaf6028 100644 --- a/eventarc/v1/eventarc-api.json +++ b/eventarc/v1/eventarc-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": "20220318", + "revision": "20220331", "rootUrl": "https://eventarc.googleapis.com/", "schemas": { "AuditConfig": { diff --git a/eventarc/v1/eventarc-gen.go b/eventarc/v1/eventarc-gen.go index e36f9d00e0a..3c4c5d28e1f 100644 --- a/eventarc/v1/eventarc-gen.go +++ b/eventarc/v1/eventarc-gen.go @@ -1667,8 +1667,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 @@ -1797,7 +1797,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/fcmdata/v1beta1/fcmdata-api.json b/fcmdata/v1beta1/fcmdata-api.json index 5c0e17bb3f8..91e47031f44 100644 --- a/fcmdata/v1beta1/fcmdata-api.json +++ b/fcmdata/v1beta1/fcmdata-api.json @@ -154,7 +154,7 @@ } } }, - "revision": "20220228", + "revision": "20220405", "rootUrl": "https://fcmdata.googleapis.com/", "schemas": { "GoogleFirebaseFcmDataV1beta1AndroidDeliveryData": { @@ -259,7 +259,7 @@ "id": "GoogleFirebaseFcmDataV1beta1MessageInsightPercents", "properties": { "priorityLowered": { - "description": "The percentage of accepted messages that had their priority lowered from high to normal due to [app standby buckets](https://firebase.google.com/docs/cloud-messaging/concept-options#setting-the-priority-of-a-message).", + "description": "The percentage of accepted messages that had their priority lowered from high to normal. See [documentation for setting message priority](https://firebase.google.com/docs/cloud-messaging/android/message-priority).", "format": "float", "type": "number" } diff --git a/fcmdata/v1beta1/fcmdata-gen.go b/fcmdata/v1beta1/fcmdata-gen.go index aa969a5cc85..fa008ade9df 100644 --- a/fcmdata/v1beta1/fcmdata-gen.go +++ b/fcmdata/v1beta1/fcmdata-gen.go @@ -384,8 +384,9 @@ func (s *GoogleFirebaseFcmDataV1beta1ListAndroidDeliveryDataResponse) MarshalJSO // with countMessagesAccepted as the denominator. type GoogleFirebaseFcmDataV1beta1MessageInsightPercents struct { // PriorityLowered: The percentage of accepted messages that had their - // priority lowered from high to normal due to app standby buckets - // (https://firebase.google.com/docs/cloud-messaging/concept-options#setting-the-priority-of-a-message). + // priority lowered from high to normal. See documentation for setting + // message priority + // (https://firebase.google.com/docs/cloud-messaging/android/message-priority). PriorityLowered float64 `json:"priorityLowered,omitempty"` // ForceSendFields is a list of field names (e.g. "PriorityLowered") to diff --git a/firebaseappcheck/v1beta/firebaseappcheck-api.json b/firebaseappcheck/v1beta/firebaseappcheck-api.json index 180c1040231..bd364decc75 100644 --- a/firebaseappcheck/v1beta/firebaseappcheck-api.json +++ b/firebaseappcheck/v1beta/firebaseappcheck-api.json @@ -287,6 +287,35 @@ "https://www.googleapis.com/auth/firebase" ] }, + "exchangePlayIntegrityToken": { + "description": "Validates an [integrity verdict response token from Play Integrity](https://developer.android.com/google/play/integrity/verdict#decrypt-verify). If valid, returns an AppCheckToken.", + "flatPath": "v1beta/projects/{projectsId}/apps/{appsId}:exchangePlayIntegrityToken", + "httpMethod": "POST", + "id": "firebaseappcheck.projects.apps.exchangePlayIntegrityToken", + "parameterOrder": [ + "app" + ], + "parameters": { + "app": { + "description": "Required. The relative resource name of the Android app, in the format: ``` projects/{project_number}/apps/{app_id} ``` If necessary, the `project_number` element can be replaced with the project ID of the Firebase project. Learn more about using project identifiers in Google's [AIP 2510](https://google.aip.dev/cloud/2510) standard.", + "location": "path", + "pattern": "^projects/[^/]+/apps/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+app}:exchangePlayIntegrityToken", + "request": { + "$ref": "GoogleFirebaseAppcheckV1betaExchangePlayIntegrityTokenRequest" + }, + "response": { + "$ref": "GoogleFirebaseAppcheckV1betaAppCheckToken" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/firebase" + ] + }, "exchangeRecaptchaEnterpriseToken": { "description": "Validates a [reCAPTCHA Enterprise response token](https://cloud.google.com/recaptcha-enterprise/docs/create-assessment#retrieve_token). If valid, returns an App Check token AppCheckToken.", "flatPath": "v1beta/projects/{projectsId}/apps/{appsId}:exchangeRecaptchaEnterpriseToken", @@ -431,6 +460,35 @@ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/firebase" ] + }, + "generatePlayIntegrityChallenge": { + "description": "Generates a challenge that protects the integrity of an immediately following integrity verdict request to the Play Integrity API. The next call to ExchangePlayIntegrityToken using the resulting integrity token will verify the presence and validity of the challenge. A challenge should not be reused for multiple calls.", + "flatPath": "v1beta/projects/{projectsId}/apps/{appsId}:generatePlayIntegrityChallenge", + "httpMethod": "POST", + "id": "firebaseappcheck.projects.apps.generatePlayIntegrityChallenge", + "parameterOrder": [ + "app" + ], + "parameters": { + "app": { + "description": "Required. The relative resource name of the app, in the format: ``` projects/{project_number}/apps/{app_id} ``` If necessary, the `project_number` element can be replaced with the project ID of the Firebase project. Learn more about using project identifiers in Google's [AIP 2510](https://google.aip.dev/cloud/2510) standard.", + "location": "path", + "pattern": "^projects/[^/]+/apps/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+app}:generatePlayIntegrityChallenge", + "request": { + "$ref": "GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeRequest" + }, + "response": { + "$ref": "GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/firebase" + ] } }, "resources": { @@ -785,6 +843,103 @@ } } }, + "playIntegrityConfig": { + "methods": { + "batchGet": { + "description": "Atomically gets the PlayIntegrityConfigs for the specified list of apps.", + "flatPath": "v1beta/projects/{projectsId}/apps/-/playIntegrityConfig:batchGet", + "httpMethod": "GET", + "id": "firebaseappcheck.projects.apps.playIntegrityConfig.batchGet", + "parameterOrder": [ + "parent" + ], + "parameters": { + "names": { + "description": "Required. The relative resource names of the PlayIntegrityConfigs to retrieve, in the format ``` projects/{project_number}/apps/{app_id}/playIntegrityConfig ``` A maximum of 100 objects can be retrieved in a batch.", + "location": "query", + "repeated": true, + "type": "string" + }, + "parent": { + "description": "Required. The parent project name shared by all PlayIntegrityConfigs being retrieved, in the format ``` projects/{project_number} ``` The parent collection in the `name` field of any resource being retrieved must match this field, or the entire batch fails.", + "location": "path", + "pattern": "^projects/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+parent}/apps/-/playIntegrityConfig:batchGet", + "response": { + "$ref": "GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/firebase" + ] + }, + "get": { + "description": "Gets the PlayIntegrityConfig for the specified app.", + "flatPath": "v1beta/projects/{projectsId}/apps/{appsId}/playIntegrityConfig", + "httpMethod": "GET", + "id": "firebaseappcheck.projects.apps.playIntegrityConfig.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The relative resource name of the PlayIntegrityConfig, in the format: ``` projects/{project_number}/apps/{app_id}/playIntegrityConfig ```", + "location": "path", + "pattern": "^projects/[^/]+/apps/[^/]+/playIntegrityConfig$", + "required": true, + "type": "string" + } + }, + "path": "v1beta/{+name}", + "response": { + "$ref": "GoogleFirebaseAppcheckV1betaPlayIntegrityConfig" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/firebase" + ] + }, + "patch": { + "description": "Updates the PlayIntegrityConfig for the specified app. While this configuration is incomplete or invalid, the app will be unable to exchange Play Integrity tokens for App Check tokens.", + "flatPath": "v1beta/projects/{projectsId}/apps/{appsId}/playIntegrityConfig", + "httpMethod": "PATCH", + "id": "firebaseappcheck.projects.apps.playIntegrityConfig.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The relative resource name of the Play Integrity configuration object, in the format: ``` projects/{project_number}/apps/{app_id}/playIntegrityConfig ```", + "location": "path", + "pattern": "^projects/[^/]+/apps/[^/]+/playIntegrityConfig$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Required. A comma-separated list of names of fields in the PlayIntegrityConfig Gets to update. Example: `token_ttl`.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1beta/{+name}", + "request": { + "$ref": "GoogleFirebaseAppcheckV1betaPlayIntegrityConfig" + }, + "response": { + "$ref": "GoogleFirebaseAppcheckV1betaPlayIntegrityConfig" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/firebase" + ] + } + } + }, "recaptchaConfig": { "methods": { "batchGet": { @@ -1309,7 +1464,7 @@ } } }, - "revision": "20220325", + "revision": "20220404", "rootUrl": "https://firebaseappcheck.googleapis.com/", "schemas": { "GoogleFirebaseAppcheckV1betaAppAttestConfig": { @@ -1392,6 +1547,20 @@ }, "type": "object" }, + "GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse": { + "description": "Response message for the BatchGetPlayIntegrityConfigs method.", + "id": "GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse", + "properties": { + "configs": { + "description": "PlayIntegrityConfigs retrieved.", + "items": { + "$ref": "GoogleFirebaseAppcheckV1betaPlayIntegrityConfig" + }, + "type": "array" + } + }, + "type": "object" + }, "GoogleFirebaseAppcheckV1betaBatchGetRecaptchaConfigsResponse": { "description": "Response message for the BatchGetRecaptchaConfigs method.", "id": "GoogleFirebaseAppcheckV1betaBatchGetRecaptchaConfigsResponse", @@ -1626,6 +1795,17 @@ }, "type": "object" }, + "GoogleFirebaseAppcheckV1betaExchangePlayIntegrityTokenRequest": { + "description": "Request message for the ExchangePlayIntegrityToken method.", + "id": "GoogleFirebaseAppcheckV1betaExchangePlayIntegrityTokenRequest", + "properties": { + "playIntegrityToken": { + "description": "Required. The [integrity verdict response token from Play Integrity](https://developer.android.com/google/play/integrity/verdict#decrypt-verify) issued to your app.", + "type": "string" + } + }, + "type": "object" + }, "GoogleFirebaseAppcheckV1betaExchangeRecaptchaEnterpriseTokenRequest": { "description": "Request message for the ExchangeRecaptchaEnterpriseToken method.", "id": "GoogleFirebaseAppcheckV1betaExchangeRecaptchaEnterpriseTokenRequest", @@ -1693,6 +1873,28 @@ }, "type": "object" }, + "GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeRequest": { + "description": "Request message for the GeneratePlayIntegrityChallenge method.", + "id": "GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeRequest", + "properties": {}, + "type": "object" + }, + "GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse": { + "description": "Response message for the GeneratePlayIntegrityChallenge method.", + "id": "GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse", + "properties": { + "challenge": { + "description": "A one-time use [challenge](https://developer.android.com/google/play/integrity/verdict#protect-against-replay-attacks) for the client to pass to the Play Integrity API.", + "type": "string" + }, + "ttl": { + "description": "The duration from the time this challenge is minted until its expiration. This field is intended to ease client-side token management, since the client may have clock skew, but is still able to accurately measure a duration.", + "format": "google-duration", + "type": "string" + } + }, + "type": "object" + }, "GoogleFirebaseAppcheckV1betaListDebugTokensResponse": { "description": "Response message for the ListDebugTokens method.", "id": "GoogleFirebaseAppcheckV1betaListDebugTokensResponse", @@ -1729,6 +1931,22 @@ }, "type": "object" }, + "GoogleFirebaseAppcheckV1betaPlayIntegrityConfig": { + "description": "An app's Play Integrity configuration object. This configuration controls certain properties of the App Check token returned by ExchangePlayIntegrityToken, such as its ttl. Note that your registered SHA-256 certificate fingerprints are used to validate tokens issued by the Play Integrity API; please register them via the Firebase Console or programmatically via the [Firebase Management Service](https://firebase.google.com/docs/projects/api/reference/rest/v1beta1/projects.androidApps.sha/create).", + "id": "GoogleFirebaseAppcheckV1betaPlayIntegrityConfig", + "properties": { + "name": { + "description": "Required. The relative resource name of the Play Integrity configuration object, in the format: ``` projects/{project_number}/apps/{app_id}/playIntegrityConfig ```", + "type": "string" + }, + "tokenTtl": { + "description": "Specifies the duration for which App Check tokens exchanged from Play Integrity tokens will be valid. If unset, a default value of 1 hour is assumed. Must be between 30 minutes and 7 days, inclusive.", + "format": "google-duration", + "type": "string" + } + }, + "type": "object" + }, "GoogleFirebaseAppcheckV1betaPublicJwk": { "description": "A JWK as specified by [section 4 of RFC 7517](https://tools.ietf.org/html/rfc7517#section-4) and [section 6.3.1 of RFC 7518](https://tools.ietf.org/html/rfc7518#section-6.3.1).", "id": "GoogleFirebaseAppcheckV1betaPublicJwk", diff --git a/firebaseappcheck/v1beta/firebaseappcheck-gen.go b/firebaseappcheck/v1beta/firebaseappcheck-gen.go index fed7ffcb2af..e0bd32b6a73 100644 --- a/firebaseappcheck/v1beta/firebaseappcheck-gen.go +++ b/firebaseappcheck/v1beta/firebaseappcheck-gen.go @@ -177,6 +177,7 @@ func NewProjectsAppsService(s *Service) *ProjectsAppsService { rs.AppAttestConfig = NewProjectsAppsAppAttestConfigService(s) rs.DebugTokens = NewProjectsAppsDebugTokensService(s) rs.DeviceCheckConfig = NewProjectsAppsDeviceCheckConfigService(s) + rs.PlayIntegrityConfig = NewProjectsAppsPlayIntegrityConfigService(s) rs.RecaptchaConfig = NewProjectsAppsRecaptchaConfigService(s) rs.RecaptchaEnterpriseConfig = NewProjectsAppsRecaptchaEnterpriseConfigService(s) rs.RecaptchaV3Config = NewProjectsAppsRecaptchaV3ConfigService(s) @@ -193,6 +194,8 @@ type ProjectsAppsService struct { DeviceCheckConfig *ProjectsAppsDeviceCheckConfigService + PlayIntegrityConfig *ProjectsAppsPlayIntegrityConfigService + RecaptchaConfig *ProjectsAppsRecaptchaConfigService RecaptchaEnterpriseConfig *ProjectsAppsRecaptchaEnterpriseConfigService @@ -229,6 +232,15 @@ type ProjectsAppsDeviceCheckConfigService struct { s *Service } +func NewProjectsAppsPlayIntegrityConfigService(s *Service) *ProjectsAppsPlayIntegrityConfigService { + rs := &ProjectsAppsPlayIntegrityConfigService{s: s} + return rs +} + +type ProjectsAppsPlayIntegrityConfigService struct { + s *Service +} + func NewProjectsAppsRecaptchaConfigService(s *Service) *ProjectsAppsRecaptchaConfigService { rs := &ProjectsAppsRecaptchaConfigService{s: s} return rs @@ -476,6 +488,39 @@ func (s *GoogleFirebaseAppcheckV1betaBatchGetDeviceCheckConfigsResponse) Marshal return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse: +// Response message for the BatchGetPlayIntegrityConfigs method. +type GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse struct { + // Configs: PlayIntegrityConfigs retrieved. + Configs []*GoogleFirebaseAppcheckV1betaPlayIntegrityConfig `json:"configs,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Configs") 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. "Configs") 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 *GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleFirebaseAppcheckV1betaBatchGetRecaptchaConfigsResponse: // Response message for the BatchGetRecaptchaConfigs method. type GoogleFirebaseAppcheckV1betaBatchGetRecaptchaConfigsResponse struct { @@ -1001,6 +1046,39 @@ func (s *GoogleFirebaseAppcheckV1betaExchangeDeviceCheckTokenRequest) MarshalJSO return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleFirebaseAppcheckV1betaExchangePlayIntegrityTokenRequest: +// Request message for the ExchangePlayIntegrityToken method. +type GoogleFirebaseAppcheckV1betaExchangePlayIntegrityTokenRequest struct { + // PlayIntegrityToken: Required. The integrity verdict response token + // from Play Integrity + // (https://developer.android.com/google/play/integrity/verdict#decrypt-verify) + // issued to your app. + PlayIntegrityToken string `json:"playIntegrityToken,omitempty"` + + // ForceSendFields is a list of field names (e.g. "PlayIntegrityToken") + // 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. "PlayIntegrityToken") 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 *GoogleFirebaseAppcheckV1betaExchangePlayIntegrityTokenRequest) MarshalJSON() ([]byte, error) { + type NoMethod GoogleFirebaseAppcheckV1betaExchangePlayIntegrityTokenRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleFirebaseAppcheckV1betaExchangeRecaptchaEnterpriseTokenRequest: // Request message for the ExchangeRecaptchaEnterpriseToken method. type GoogleFirebaseAppcheckV1betaExchangeRecaptchaEnterpriseTokenRequest struct { @@ -1175,6 +1253,52 @@ func (s *GoogleFirebaseAppcheckV1betaGenerateAppAttestChallengeResponse) Marshal return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeRequest: +// Request message for the GeneratePlayIntegrityChallenge method. +type GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeRequest struct { +} + +// GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse: +// Response message for the GeneratePlayIntegrityChallenge method. +type GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse struct { + // Challenge: A one-time use challenge + // (https://developer.android.com/google/play/integrity/verdict#protect-against-replay-attacks) + // for the client to pass to the Play Integrity API. + Challenge string `json:"challenge,omitempty"` + + // Ttl: The duration from the time this challenge is minted until its + // expiration. This field is intended to ease client-side token + // management, since the client may have clock skew, but is still able + // to accurately measure a duration. + Ttl string `json:"ttl,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Challenge") 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. "Challenge") 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 *GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleFirebaseAppcheckV1betaListDebugTokensResponse: Response message // for the ListDebugTokens method. type GoogleFirebaseAppcheckV1betaListDebugTokensResponse struct { @@ -1257,6 +1381,54 @@ func (s *GoogleFirebaseAppcheckV1betaListServicesResponse) MarshalJSON() ([]byte return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleFirebaseAppcheckV1betaPlayIntegrityConfig: An app's Play +// Integrity configuration object. This configuration controls certain +// properties of the App Check token returned by +// ExchangePlayIntegrityToken, such as its ttl. Note that your +// registered SHA-256 certificate fingerprints are used to validate +// tokens issued by the Play Integrity API; please register them via the +// Firebase Console or programmatically via the Firebase Management +// Service +// (https://firebase.google.com/docs/projects/api/reference/rest/v1beta1/projects.androidApps.sha/create). +type GoogleFirebaseAppcheckV1betaPlayIntegrityConfig struct { + // Name: Required. The relative resource name of the Play Integrity + // configuration object, in the format: ``` + // projects/{project_number}/apps/{app_id}/playIntegrityConfig ``` + Name string `json:"name,omitempty"` + + // TokenTtl: Specifies the duration for which App Check tokens exchanged + // from Play Integrity tokens will be valid. If unset, a default value + // of 1 hour is assumed. Must be between 30 minutes and 7 days, + // inclusive. + TokenTtl string `json:"tokenTtl,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Name") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. 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. "Name") 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 *GoogleFirebaseAppcheckV1betaPlayIntegrityConfig) MarshalJSON() ([]byte, error) { + type NoMethod GoogleFirebaseAppcheckV1betaPlayIntegrityConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleFirebaseAppcheckV1betaPublicJwk: A JWK as specified by section // 4 of RFC 7517 (https://tools.ietf.org/html/rfc7517#section-4) and // section 6.3.1 of RFC 7518 @@ -2592,6 +2764,158 @@ func (c *ProjectsAppsExchangeDeviceCheckTokenCall) Do(opts ...googleapi.CallOpti } +// method id "firebaseappcheck.projects.apps.exchangePlayIntegrityToken": + +type ProjectsAppsExchangePlayIntegrityTokenCall struct { + s *Service + appid string + googlefirebaseappcheckv1betaexchangeplayintegritytokenrequest *GoogleFirebaseAppcheckV1betaExchangePlayIntegrityTokenRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// ExchangePlayIntegrityToken: Validates an integrity verdict response +// token from Play Integrity +// (https://developer.android.com/google/play/integrity/verdict#decrypt-verify). +// If valid, returns an AppCheckToken. +// +// - app: The relative resource name of the Android app, in the format: +// ``` projects/{project_number}/apps/{app_id} ``` If necessary, the +// `project_number` element can be replaced with the project ID of the +// Firebase project. Learn more about using project identifiers in +// Google's AIP 2510 (https://google.aip.dev/cloud/2510) standard. +func (r *ProjectsAppsService) ExchangePlayIntegrityToken(appid string, googlefirebaseappcheckv1betaexchangeplayintegritytokenrequest *GoogleFirebaseAppcheckV1betaExchangePlayIntegrityTokenRequest) *ProjectsAppsExchangePlayIntegrityTokenCall { + c := &ProjectsAppsExchangePlayIntegrityTokenCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.appid = appid + c.googlefirebaseappcheckv1betaexchangeplayintegritytokenrequest = googlefirebaseappcheckv1betaexchangeplayintegritytokenrequest + 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 *ProjectsAppsExchangePlayIntegrityTokenCall) Fields(s ...googleapi.Field) *ProjectsAppsExchangePlayIntegrityTokenCall { + 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 *ProjectsAppsExchangePlayIntegrityTokenCall) Context(ctx context.Context) *ProjectsAppsExchangePlayIntegrityTokenCall { + 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 *ProjectsAppsExchangePlayIntegrityTokenCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsAppsExchangePlayIntegrityTokenCall) 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.googlefirebaseappcheckv1betaexchangeplayintegritytokenrequest) + 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, "v1beta/{+app}:exchangePlayIntegrityToken") + 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{ + "app": c.appid, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "firebaseappcheck.projects.apps.exchangePlayIntegrityToken" call. +// Exactly one of *GoogleFirebaseAppcheckV1betaAppCheckToken or error +// will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleFirebaseAppcheckV1betaAppCheckToken.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 *ProjectsAppsExchangePlayIntegrityTokenCall) Do(opts ...googleapi.CallOption) (*GoogleFirebaseAppcheckV1betaAppCheckToken, 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 := &GoogleFirebaseAppcheckV1betaAppCheckToken{ + 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": "Validates an [integrity verdict response token from Play Integrity](https://developer.android.com/google/play/integrity/verdict#decrypt-verify). If valid, returns an AppCheckToken.", + // "flatPath": "v1beta/projects/{projectsId}/apps/{appsId}:exchangePlayIntegrityToken", + // "httpMethod": "POST", + // "id": "firebaseappcheck.projects.apps.exchangePlayIntegrityToken", + // "parameterOrder": [ + // "app" + // ], + // "parameters": { + // "app": { + // "description": "Required. The relative resource name of the Android app, in the format: ``` projects/{project_number}/apps/{app_id} ``` If necessary, the `project_number` element can be replaced with the project ID of the Firebase project. Learn more about using project identifiers in Google's [AIP 2510](https://google.aip.dev/cloud/2510) standard.", + // "location": "path", + // "pattern": "^projects/[^/]+/apps/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1beta/{+app}:exchangePlayIntegrityToken", + // "request": { + // "$ref": "GoogleFirebaseAppcheckV1betaExchangePlayIntegrityTokenRequest" + // }, + // "response": { + // "$ref": "GoogleFirebaseAppcheckV1betaAppCheckToken" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/firebase" + // ] + // } + +} + // method id "firebaseappcheck.projects.apps.exchangeRecaptchaEnterpriseToken": type ProjectsAppsExchangeRecaptchaEnterpriseTokenCall struct { @@ -3350,11 +3674,166 @@ func (c *ProjectsAppsGenerateAppAttestChallengeCall) Do(opts ...googleapi.CallOp } -// method id "firebaseappcheck.projects.apps.appAttestConfig.batchGet": +// method id "firebaseappcheck.projects.apps.generatePlayIntegrityChallenge": -type ProjectsAppsAppAttestConfigBatchGetCall struct { - s *Service - parent string +type ProjectsAppsGeneratePlayIntegrityChallengeCall struct { + s *Service + appid string + googlefirebaseappcheckv1betagenerateplayintegritychallengerequest *GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// GeneratePlayIntegrityChallenge: Generates a challenge that protects +// the integrity of an immediately following integrity verdict request +// to the Play Integrity API. The next call to +// ExchangePlayIntegrityToken using the resulting integrity token will +// verify the presence and validity of the challenge. A challenge should +// not be reused for multiple calls. +// +// - app: The relative resource name of the app, in the format: ``` +// projects/{project_number}/apps/{app_id} ``` If necessary, the +// `project_number` element can be replaced with the project ID of the +// Firebase project. Learn more about using project identifiers in +// Google's AIP 2510 (https://google.aip.dev/cloud/2510) standard. +func (r *ProjectsAppsService) GeneratePlayIntegrityChallenge(appid string, googlefirebaseappcheckv1betagenerateplayintegritychallengerequest *GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeRequest) *ProjectsAppsGeneratePlayIntegrityChallengeCall { + c := &ProjectsAppsGeneratePlayIntegrityChallengeCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.appid = appid + c.googlefirebaseappcheckv1betagenerateplayintegritychallengerequest = googlefirebaseappcheckv1betagenerateplayintegritychallengerequest + 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 *ProjectsAppsGeneratePlayIntegrityChallengeCall) Fields(s ...googleapi.Field) *ProjectsAppsGeneratePlayIntegrityChallengeCall { + 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 *ProjectsAppsGeneratePlayIntegrityChallengeCall) Context(ctx context.Context) *ProjectsAppsGeneratePlayIntegrityChallengeCall { + 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 *ProjectsAppsGeneratePlayIntegrityChallengeCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsAppsGeneratePlayIntegrityChallengeCall) 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.googlefirebaseappcheckv1betagenerateplayintegritychallengerequest) + 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, "v1beta/{+app}:generatePlayIntegrityChallenge") + 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{ + "app": c.appid, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "firebaseappcheck.projects.apps.generatePlayIntegrityChallenge" call. +// Exactly one of +// *GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse +// or error will be non-nil. Any non-2xx status code is an error. +// Response headers are in either +// *GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse.Se +// rverResponse.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 *ProjectsAppsGeneratePlayIntegrityChallengeCall) Do(opts ...googleapi.CallOption) (*GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse, 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 := &GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse{ + 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": "Generates a challenge that protects the integrity of an immediately following integrity verdict request to the Play Integrity API. The next call to ExchangePlayIntegrityToken using the resulting integrity token will verify the presence and validity of the challenge. A challenge should not be reused for multiple calls.", + // "flatPath": "v1beta/projects/{projectsId}/apps/{appsId}:generatePlayIntegrityChallenge", + // "httpMethod": "POST", + // "id": "firebaseappcheck.projects.apps.generatePlayIntegrityChallenge", + // "parameterOrder": [ + // "app" + // ], + // "parameters": { + // "app": { + // "description": "Required. The relative resource name of the app, in the format: ``` projects/{project_number}/apps/{app_id} ``` If necessary, the `project_number` element can be replaced with the project ID of the Firebase project. Learn more about using project identifiers in Google's [AIP 2510](https://google.aip.dev/cloud/2510) standard.", + // "location": "path", + // "pattern": "^projects/[^/]+/apps/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1beta/{+app}:generatePlayIntegrityChallenge", + // "request": { + // "$ref": "GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeRequest" + // }, + // "response": { + // "$ref": "GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/firebase" + // ] + // } + +} + +// method id "firebaseappcheck.projects.apps.appAttestConfig.batchGet": + +type ProjectsAppsAppAttestConfigBatchGetCall struct { + s *Service + parent string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context @@ -5128,6 +5607,489 @@ func (c *ProjectsAppsDeviceCheckConfigPatchCall) Do(opts ...googleapi.CallOption } +// method id "firebaseappcheck.projects.apps.playIntegrityConfig.batchGet": + +type ProjectsAppsPlayIntegrityConfigBatchGetCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// BatchGet: Atomically gets the PlayIntegrityConfigs for the specified +// list of apps. +// +// - parent: The parent project name shared by all PlayIntegrityConfigs +// being retrieved, in the format ``` projects/{project_number} ``` +// The parent collection in the `name` field of any resource being +// retrieved must match this field, or the entire batch fails. +func (r *ProjectsAppsPlayIntegrityConfigService) BatchGet(parent string) *ProjectsAppsPlayIntegrityConfigBatchGetCall { + c := &ProjectsAppsPlayIntegrityConfigBatchGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// Names sets the optional parameter "names": Required. The relative +// resource names of the PlayIntegrityConfigs to retrieve, in the format +// ``` projects/{project_number}/apps/{app_id}/playIntegrityConfig ``` A +// maximum of 100 objects can be retrieved in a batch. +func (c *ProjectsAppsPlayIntegrityConfigBatchGetCall) Names(names ...string) *ProjectsAppsPlayIntegrityConfigBatchGetCall { + c.urlParams_.SetMulti("names", append([]string{}, names...)) + 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 *ProjectsAppsPlayIntegrityConfigBatchGetCall) Fields(s ...googleapi.Field) *ProjectsAppsPlayIntegrityConfigBatchGetCall { + 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 *ProjectsAppsPlayIntegrityConfigBatchGetCall) IfNoneMatch(entityTag string) *ProjectsAppsPlayIntegrityConfigBatchGetCall { + 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 *ProjectsAppsPlayIntegrityConfigBatchGetCall) Context(ctx context.Context) *ProjectsAppsPlayIntegrityConfigBatchGetCall { + 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 *ProjectsAppsPlayIntegrityConfigBatchGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsAppsPlayIntegrityConfigBatchGetCall) 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, "v1beta/{+parent}/apps/-/playIntegrityConfig:batchGet") + 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 "firebaseappcheck.projects.apps.playIntegrityConfig.batchGet" call. +// Exactly one of +// *GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse or +// error will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse.Serv +// erResponse.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 *ProjectsAppsPlayIntegrityConfigBatchGetCall) Do(opts ...googleapi.CallOption) (*GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse, 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 := &GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse{ + 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": "Atomically gets the PlayIntegrityConfigs for the specified list of apps.", + // "flatPath": "v1beta/projects/{projectsId}/apps/-/playIntegrityConfig:batchGet", + // "httpMethod": "GET", + // "id": "firebaseappcheck.projects.apps.playIntegrityConfig.batchGet", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "names": { + // "description": "Required. The relative resource names of the PlayIntegrityConfigs to retrieve, in the format ``` projects/{project_number}/apps/{app_id}/playIntegrityConfig ``` A maximum of 100 objects can be retrieved in a batch.", + // "location": "query", + // "repeated": true, + // "type": "string" + // }, + // "parent": { + // "description": "Required. The parent project name shared by all PlayIntegrityConfigs being retrieved, in the format ``` projects/{project_number} ``` The parent collection in the `name` field of any resource being retrieved must match this field, or the entire batch fails.", + // "location": "path", + // "pattern": "^projects/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1beta/{+parent}/apps/-/playIntegrityConfig:batchGet", + // "response": { + // "$ref": "GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/firebase" + // ] + // } + +} + +// method id "firebaseappcheck.projects.apps.playIntegrityConfig.get": + +type ProjectsAppsPlayIntegrityConfigGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets the PlayIntegrityConfig for the specified app. +// +// - name: The relative resource name of the PlayIntegrityConfig, in the +// format: ``` +// projects/{project_number}/apps/{app_id}/playIntegrityConfig ```. +func (r *ProjectsAppsPlayIntegrityConfigService) Get(name string) *ProjectsAppsPlayIntegrityConfigGetCall { + c := &ProjectsAppsPlayIntegrityConfigGetCall{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 *ProjectsAppsPlayIntegrityConfigGetCall) Fields(s ...googleapi.Field) *ProjectsAppsPlayIntegrityConfigGetCall { + 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 *ProjectsAppsPlayIntegrityConfigGetCall) IfNoneMatch(entityTag string) *ProjectsAppsPlayIntegrityConfigGetCall { + 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 *ProjectsAppsPlayIntegrityConfigGetCall) Context(ctx context.Context) *ProjectsAppsPlayIntegrityConfigGetCall { + 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 *ProjectsAppsPlayIntegrityConfigGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsAppsPlayIntegrityConfigGetCall) 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, "v1beta/{+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 "firebaseappcheck.projects.apps.playIntegrityConfig.get" call. +// Exactly one of *GoogleFirebaseAppcheckV1betaPlayIntegrityConfig or +// error will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleFirebaseAppcheckV1betaPlayIntegrityConfig.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 *ProjectsAppsPlayIntegrityConfigGetCall) Do(opts ...googleapi.CallOption) (*GoogleFirebaseAppcheckV1betaPlayIntegrityConfig, 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 := &GoogleFirebaseAppcheckV1betaPlayIntegrityConfig{ + 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 PlayIntegrityConfig for the specified app.", + // "flatPath": "v1beta/projects/{projectsId}/apps/{appsId}/playIntegrityConfig", + // "httpMethod": "GET", + // "id": "firebaseappcheck.projects.apps.playIntegrityConfig.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The relative resource name of the PlayIntegrityConfig, in the format: ``` projects/{project_number}/apps/{app_id}/playIntegrityConfig ```", + // "location": "path", + // "pattern": "^projects/[^/]+/apps/[^/]+/playIntegrityConfig$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1beta/{+name}", + // "response": { + // "$ref": "GoogleFirebaseAppcheckV1betaPlayIntegrityConfig" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/firebase" + // ] + // } + +} + +// method id "firebaseappcheck.projects.apps.playIntegrityConfig.patch": + +type ProjectsAppsPlayIntegrityConfigPatchCall struct { + s *Service + name string + googlefirebaseappcheckv1betaplayintegrityconfig *GoogleFirebaseAppcheckV1betaPlayIntegrityConfig + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates the PlayIntegrityConfig for the specified app. While +// this configuration is incomplete or invalid, the app will be unable +// to exchange Play Integrity tokens for App Check tokens. +// +// - name: The relative resource name of the Play Integrity +// configuration object, in the format: ``` +// projects/{project_number}/apps/{app_id}/playIntegrityConfig ```. +func (r *ProjectsAppsPlayIntegrityConfigService) Patch(name string, googlefirebaseappcheckv1betaplayintegrityconfig *GoogleFirebaseAppcheckV1betaPlayIntegrityConfig) *ProjectsAppsPlayIntegrityConfigPatchCall { + c := &ProjectsAppsPlayIntegrityConfigPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googlefirebaseappcheckv1betaplayintegrityconfig = googlefirebaseappcheckv1betaplayintegrityconfig + return c +} + +// UpdateMask sets the optional parameter "updateMask": Required. A +// comma-separated list of names of fields in the PlayIntegrityConfig +// Gets to update. Example: `token_ttl`. +func (c *ProjectsAppsPlayIntegrityConfigPatchCall) UpdateMask(updateMask string) *ProjectsAppsPlayIntegrityConfigPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsAppsPlayIntegrityConfigPatchCall) Fields(s ...googleapi.Field) *ProjectsAppsPlayIntegrityConfigPatchCall { + 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 *ProjectsAppsPlayIntegrityConfigPatchCall) Context(ctx context.Context) *ProjectsAppsPlayIntegrityConfigPatchCall { + 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 *ProjectsAppsPlayIntegrityConfigPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsAppsPlayIntegrityConfigPatchCall) 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.googlefirebaseappcheckv1betaplayintegrityconfig) + 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, "v1beta/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "firebaseappcheck.projects.apps.playIntegrityConfig.patch" call. +// Exactly one of *GoogleFirebaseAppcheckV1betaPlayIntegrityConfig or +// error will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *GoogleFirebaseAppcheckV1betaPlayIntegrityConfig.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 *ProjectsAppsPlayIntegrityConfigPatchCall) Do(opts ...googleapi.CallOption) (*GoogleFirebaseAppcheckV1betaPlayIntegrityConfig, 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 := &GoogleFirebaseAppcheckV1betaPlayIntegrityConfig{ + 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 PlayIntegrityConfig for the specified app. While this configuration is incomplete or invalid, the app will be unable to exchange Play Integrity tokens for App Check tokens.", + // "flatPath": "v1beta/projects/{projectsId}/apps/{appsId}/playIntegrityConfig", + // "httpMethod": "PATCH", + // "id": "firebaseappcheck.projects.apps.playIntegrityConfig.patch", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The relative resource name of the Play Integrity configuration object, in the format: ``` projects/{project_number}/apps/{app_id}/playIntegrityConfig ```", + // "location": "path", + // "pattern": "^projects/[^/]+/apps/[^/]+/playIntegrityConfig$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "Required. A comma-separated list of names of fields in the PlayIntegrityConfig Gets to update. Example: `token_ttl`.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1beta/{+name}", + // "request": { + // "$ref": "GoogleFirebaseAppcheckV1betaPlayIntegrityConfig" + // }, + // "response": { + // "$ref": "GoogleFirebaseAppcheckV1betaPlayIntegrityConfig" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/firebase" + // ] + // } + +} + // method id "firebaseappcheck.projects.apps.recaptchaConfig.batchGet": type ProjectsAppsRecaptchaConfigBatchGetCall struct { diff --git a/firestore/v1/firestore-api.json b/firestore/v1/firestore-api.json index 506e31d11f9..78e111eafcd 100644 --- a/firestore/v1/firestore-api.json +++ b/firestore/v1/firestore-api.json @@ -1055,6 +1055,35 @@ "https://www.googleapis.com/auth/datastore" ] }, + "runAggregationQuery": { + "description": "Runs an aggregation query. Rather than producing Document results like Firestore.RunQuery, this API allows running an aggregation to produce a series of AggregationResult server-side. High-Level Example: ``` -- Return the number of documents in table given a filter. SELECT COUNT(*) FROM ( SELECT * FROM k where a = true ); ```", + "flatPath": "v1/projects/{projectsId}/databases/{databasesId}/documents/{documentsId}/{documentsId1}:runAggregationQuery", + "httpMethod": "POST", + "id": "firestore.projects.databases.documents.runAggregationQuery", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource name. In the format: `projects/{project_id}/databases/{database_id}/documents` or `projects/{project_id}/databases/{database_id}/documents/{document_path}`. For example: `projects/my-project/databases/my-database/documents` or `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom`", + "location": "path", + "pattern": "^projects/[^/]+/databases/[^/]+/documents/[^/]+/.*$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}:runAggregationQuery", + "request": { + "$ref": "RunAggregationQueryRequest" + }, + "response": { + "$ref": "RunAggregationQueryResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/datastore" + ] + }, "runQuery": { "description": "Runs a query.", "flatPath": "v1/projects/{projectsId}/databases/{databasesId}/documents/{documentsId}/{documentsId1}:runQuery", @@ -1282,7 +1311,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" }, @@ -1319,9 +1348,38 @@ } } }, - "revision": "20220319", + "revision": "20220402", "rootUrl": "https://firestore.googleapis.com/", "schemas": { + "Aggregation": { + "description": "Defines a aggregation that produces a single result.", + "id": "Aggregation", + "properties": { + "alias": { + "description": "Required. The name of the field to store the result of the aggregation into. Requires: * Must be present. * Must be unique across all aggregation aliases. * Conform to existing document field name limitations.", + "type": "string" + }, + "count": { + "$ref": "Count", + "description": "Count aggregator." + } + }, + "type": "object" + }, + "AggregationResult": { + "description": "The result of a single bucket from a Firestore aggregation query. The keys of `aggregate_fields` are the same for all results in an aggregation query, unlike document queries which can have different fields present for each result.", + "id": "AggregationResult", + "properties": { + "aggregateFields": { + "additionalProperties": { + "$ref": "Value" + }, + "description": "The result of the aggregation functions, ex: `COUNT(*) AS total_docs`. The key is the alias assigned to the aggregation function on input and the size of this map equals the number of aggregation functions in the query.", + "type": "object" + } + }, + "type": "object" + }, "ArrayValue": { "description": "An array value.", "id": "ArrayValue", @@ -1516,7 +1574,7 @@ "id": "CompositeFilter", "properties": { "filters": { - "description": "The list of filters to combine. Must contain at least one filter.", + "description": "The list of filters to combine. Requires: * At least one filter is present.", "items": { "$ref": "Filter" }, @@ -1530,13 +1588,25 @@ ], "enumDescriptions": [ "Unspecified. This value must not be used.", - "The results are required to satisfy each of the combined filters." + "Documents are required to satisfy all of the combined filters." ], "type": "string" } }, "type": "object" }, + "Count": { + "description": "Count of documents that match the query. The `COUNT(*)` aggregation function operates on the entire document so it does not require a field reference.", + "id": "Count", + "properties": { + "upTo": { + "description": "Optional. Optional constraint on the maximum number of documents to count. This provides a way to set an upper bound on the number of documents to scan, limiting latency and cost. High-Level Example: ``` SELECT COUNT_UP_TO(1000) FROM ( SELECT * FROM k ); ``` Requires: * Must be greater than zero when present.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "Cursor": { "description": "A position in a query result set.", "id": "Cursor", @@ -2815,6 +2885,52 @@ }, "type": "object" }, + "RunAggregationQueryRequest": { + "description": "The request for Firestore.RunAggregationQuery.", + "id": "RunAggregationQueryRequest", + "properties": { + "newTransaction": { + "$ref": "TransactionOptions", + "description": "Starts a new transaction as part of the query, defaulting to read-only. The new transaction ID will be returned as the first response in the stream." + }, + "readTime": { + "description": "Executes the query at the given timestamp. Requires: * Cannot be more than 270 seconds in the past.", + "format": "google-datetime", + "type": "string" + }, + "structuredAggregationQuery": { + "$ref": "StructuredAggregationQuery", + "description": "An aggregation query." + }, + "transaction": { + "description": "Run the aggregation within an already active transaction. The value here is the opaque transaction ID to execute the query in.", + "format": "byte", + "type": "string" + } + }, + "type": "object" + }, + "RunAggregationQueryResponse": { + "description": "The response for Firestore.RunAggregationQuery.", + "id": "RunAggregationQueryResponse", + "properties": { + "readTime": { + "description": "The time at which the aggregate value is valid for.", + "format": "google-datetime", + "type": "string" + }, + "result": { + "$ref": "AggregationResult", + "description": "A single aggregation result. Not present when reporting partial progress or when the query produced zero results." + }, + "transaction": { + "description": "The transaction that was started as part of this request. Only present on the first response when the request requested to start a new transaction.", + "format": "byte", + "type": "string" + } + }, + "type": "object" + }, "RunQueryRequest": { "description": "The request for Firestore.RunQuery.", "id": "RunQueryRequest", @@ -2848,10 +2964,6 @@ "$ref": "Document", "description": "A query result, not set when reporting partial progress." }, - "done": { - "description": "If present, Firestore has completely finished the request and no more documents will be returned.", - "type": "boolean" - }, "readTime": { "description": "The time at which the document was read. This may be monotonically increasing; in this case, the previous documents in the result stream are guaranteed not to have changed between their `read_time` and this one. If the query returns no results, a response with `read_time` and no `document` will be sent, and this represents the time at which the query was run.", "format": "google-datetime", @@ -2897,6 +3009,24 @@ }, "type": "object" }, + "StructuredAggregationQuery": { + "description": "Firestore query for running an aggregation over a StructuredQuery.", + "id": "StructuredAggregationQuery", + "properties": { + "aggregations": { + "description": "Optional. Series of aggregations to apply on top of the `structured_query`.", + "items": { + "$ref": "Aggregation" + }, + "type": "array" + }, + "structuredQuery": { + "$ref": "StructuredQuery", + "description": "Nested structured query." + } + }, + "type": "object" + }, "StructuredQuery": { "description": "A Firestore query.", "id": "StructuredQuery", diff --git a/firestore/v1/firestore-gen.go b/firestore/v1/firestore-gen.go index f6742197278..d8ed1d99b55 100644 --- a/firestore/v1/firestore-gen.go +++ b/firestore/v1/firestore-gen.go @@ -240,6 +240,75 @@ type ProjectsLocationsService struct { s *Service } +// Aggregation: Defines a aggregation that produces a single result. +type Aggregation struct { + // Alias: Required. The name of the field to store the result of the + // aggregation into. Requires: * Must be present. * Must be unique + // across all aggregation aliases. * Conform to existing document field + // name limitations. + Alias string `json:"alias,omitempty"` + + // Count: Count aggregator. + Count *Count `json:"count,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Alias") 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. "Alias") 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 *Aggregation) MarshalJSON() ([]byte, error) { + type NoMethod Aggregation + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// AggregationResult: The result of a single bucket from a Firestore +// aggregation query. The keys of `aggregate_fields` are the same for +// all results in an aggregation query, unlike document queries which +// can have different fields present for each result. +type AggregationResult struct { + // AggregateFields: The result of the aggregation functions, ex: + // `COUNT(*) AS total_docs`. The key is the alias assigned to the + // aggregation function on input and the size of this map equals the + // number of aggregation functions in the query. + AggregateFields map[string]Value `json:"aggregateFields,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AggregateFields") 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. "AggregateFields") 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 *AggregationResult) MarshalJSON() ([]byte, error) { + type NoMethod AggregationResult + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ArrayValue: An array value. type ArrayValue struct { // Values: Values in the array. @@ -609,15 +678,15 @@ func (s *CommitResponse) MarshalJSON() ([]byte, error) { // CompositeFilter: A filter that merges multiple other filters using // the given operator. type CompositeFilter struct { - // Filters: The list of filters to combine. Must contain at least one - // filter. + // Filters: The list of filters to combine. Requires: * At least one + // filter is present. Filters []*Filter `json:"filters,omitempty"` // Op: The operator for combining multiple filters. // // Possible values: // "OPERATOR_UNSPECIFIED" - Unspecified. This value must not be used. - // "AND" - The results are required to satisfy each of the combined + // "AND" - Documents are required to satisfy all of the combined // filters. Op string `json:"op,omitempty"` @@ -644,6 +713,40 @@ func (s *CompositeFilter) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// Count: Count of documents that match the query. The `COUNT(*)` +// aggregation function operates on the entire document so it does not +// require a field reference. +type Count struct { + // UpTo: Optional. Optional constraint on the maximum number of + // documents to count. This provides a way to set an upper bound on the + // number of documents to scan, limiting latency and cost. High-Level + // Example: ``` SELECT COUNT_UP_TO(1000) FROM ( SELECT * FROM k ); ``` + // Requires: * Must be greater than zero when present. + UpTo int64 `json:"upTo,omitempty"` + + // ForceSendFields is a list of field names (e.g. "UpTo") 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. "UpTo") 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 *Count) MarshalJSON() ([]byte, error) { + type NoMethod Count + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Cursor: A position in a query result set. type Cursor struct { // Before: If the position is just before or just after the given @@ -2915,6 +3018,92 @@ func (s *RollbackRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// RunAggregationQueryRequest: The request for +// Firestore.RunAggregationQuery. +type RunAggregationQueryRequest struct { + // NewTransaction: Starts a new transaction as part of the query, + // defaulting to read-only. The new transaction ID will be returned as + // the first response in the stream. + NewTransaction *TransactionOptions `json:"newTransaction,omitempty"` + + // ReadTime: Executes the query at the given timestamp. Requires: * + // Cannot be more than 270 seconds in the past. + ReadTime string `json:"readTime,omitempty"` + + // StructuredAggregationQuery: An aggregation query. + StructuredAggregationQuery *StructuredAggregationQuery `json:"structuredAggregationQuery,omitempty"` + + // Transaction: Run the aggregation within an already active + // transaction. The value here is the opaque transaction ID to execute + // the query in. + Transaction string `json:"transaction,omitempty"` + + // ForceSendFields is a list of field names (e.g. "NewTransaction") 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. "NewTransaction") 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 *RunAggregationQueryRequest) MarshalJSON() ([]byte, error) { + type NoMethod RunAggregationQueryRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// RunAggregationQueryResponse: The response for +// Firestore.RunAggregationQuery. +type RunAggregationQueryResponse struct { + // ReadTime: The time at which the aggregate value is valid for. + ReadTime string `json:"readTime,omitempty"` + + // Result: A single aggregation result. Not present when reporting + // partial progress or when the query produced zero results. + Result *AggregationResult `json:"result,omitempty"` + + // Transaction: The transaction that was started as part of this + // request. Only present on the first response when the request + // requested to start a new transaction. + Transaction string `json:"transaction,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "ReadTime") 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. "ReadTime") 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 *RunAggregationQueryResponse) MarshalJSON() ([]byte, error) { + type NoMethod RunAggregationQueryResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // RunQueryRequest: The request for Firestore.RunQuery. type RunQueryRequest struct { // NewTransaction: Starts a new transaction and reads the documents. @@ -2962,10 +3151,6 @@ type RunQueryResponse struct { // Document: A query result, not set when reporting partial progress. Document *Document `json:"document,omitempty"` - // Done: If present, Firestore has completely finished the request and - // no more documents will be returned. - Done bool `json:"done,omitempty"` - // ReadTime: The time at which the document was read. This may be // monotonically increasing; in this case, the previous documents in the // result stream are guaranteed not to have changed between their @@ -3055,6 +3240,39 @@ func (s *Status) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// StructuredAggregationQuery: Firestore query for running an +// aggregation over a StructuredQuery. +type StructuredAggregationQuery struct { + // Aggregations: Optional. Series of aggregations to apply on top of the + // `structured_query`. + Aggregations []*Aggregation `json:"aggregations,omitempty"` + + // StructuredQuery: Nested structured query. + StructuredQuery *StructuredQuery `json:"structuredQuery,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Aggregations") 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. "Aggregations") 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 *StructuredAggregationQuery) MarshalJSON() ([]byte, error) { + type NoMethod StructuredAggregationQuery + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // StructuredQuery: A Firestore query. type StructuredQuery struct { // EndAt: A end point for the query results. @@ -8043,6 +8261,160 @@ func (c *ProjectsDatabasesDocumentsRollbackCall) Do(opts ...googleapi.CallOption } +// method id "firestore.projects.databases.documents.runAggregationQuery": + +type ProjectsDatabasesDocumentsRunAggregationQueryCall struct { + s *Service + parent string + runaggregationqueryrequest *RunAggregationQueryRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// RunAggregationQuery: Runs an aggregation query. Rather than producing +// Document results like Firestore.RunQuery, this API allows running an +// aggregation to produce a series of AggregationResult server-side. +// High-Level Example: ``` -- Return the number of documents in table +// given a filter. SELECT COUNT(*) FROM ( SELECT * FROM k where a = true +// ); ``` +// +// - parent: The parent resource name. In the format: +// `projects/{project_id}/databases/{database_id}/documents` or +// `projects/{project_id}/databases/{database_id}/documents/{document_p +// ath}`. For example: +// `projects/my-project/databases/my-database/documents` or +// `projects/my-project/databases/my-database/documents/chatrooms/my-ch +// atroom`. +func (r *ProjectsDatabasesDocumentsService) RunAggregationQuery(parent string, runaggregationqueryrequest *RunAggregationQueryRequest) *ProjectsDatabasesDocumentsRunAggregationQueryCall { + c := &ProjectsDatabasesDocumentsRunAggregationQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.runaggregationqueryrequest = runaggregationqueryrequest + 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 *ProjectsDatabasesDocumentsRunAggregationQueryCall) Fields(s ...googleapi.Field) *ProjectsDatabasesDocumentsRunAggregationQueryCall { + 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 *ProjectsDatabasesDocumentsRunAggregationQueryCall) Context(ctx context.Context) *ProjectsDatabasesDocumentsRunAggregationQueryCall { + 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 *ProjectsDatabasesDocumentsRunAggregationQueryCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsDatabasesDocumentsRunAggregationQueryCall) 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.runaggregationqueryrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}:runAggregationQuery") + 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 "firestore.projects.databases.documents.runAggregationQuery" call. +// Exactly one of *RunAggregationQueryResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *RunAggregationQueryResponse.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 *ProjectsDatabasesDocumentsRunAggregationQueryCall) Do(opts ...googleapi.CallOption) (*RunAggregationQueryResponse, 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 := &RunAggregationQueryResponse{ + 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": "Runs an aggregation query. Rather than producing Document results like Firestore.RunQuery, this API allows running an aggregation to produce a series of AggregationResult server-side. High-Level Example: ``` -- Return the number of documents in table given a filter. SELECT COUNT(*) FROM ( SELECT * FROM k where a = true ); ```", + // "flatPath": "v1/projects/{projectsId}/databases/{databasesId}/documents/{documentsId}/{documentsId1}:runAggregationQuery", + // "httpMethod": "POST", + // "id": "firestore.projects.databases.documents.runAggregationQuery", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The parent resource name. In the format: `projects/{project_id}/databases/{database_id}/documents` or `projects/{project_id}/databases/{database_id}/documents/{document_path}`. For example: `projects/my-project/databases/my-database/documents` or `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom`", + // "location": "path", + // "pattern": "^projects/[^/]+/databases/[^/]+/documents/[^/]+/.*$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}:runAggregationQuery", + // "request": { + // "$ref": "RunAggregationQueryRequest" + // }, + // "response": { + // "$ref": "RunAggregationQueryResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/datastore" + // ] + // } + +} + // method id "firestore.projects.databases.documents.runQuery": type ProjectsDatabasesDocumentsRunQueryCall struct { @@ -9160,8 +9532,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 @@ -9290,7 +9662,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/firestore/v1beta1/firestore-api.json b/firestore/v1beta1/firestore-api.json index 2c8ad0ce0ef..d13de60400e 100644 --- a/firestore/v1beta1/firestore-api.json +++ b/firestore/v1beta1/firestore-api.json @@ -730,6 +730,35 @@ "https://www.googleapis.com/auth/datastore" ] }, + "runAggregationQuery": { + "description": "Runs an aggregation query. Rather than producing Document results like Firestore.RunQuery, this API allows running an aggregation to produce a series of AggregationResult server-side. High-Level Example: ``` -- Return the number of documents in table given a filter. SELECT COUNT(*) FROM ( SELECT * FROM k where a = true ); ```", + "flatPath": "v1beta1/projects/{projectsId}/databases/{databasesId}/documents/{documentsId}/{documentsId1}:runAggregationQuery", + "httpMethod": "POST", + "id": "firestore.projects.databases.documents.runAggregationQuery", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The parent resource name. In the format: `projects/{project_id}/databases/{database_id}/documents` or `projects/{project_id}/databases/{database_id}/documents/{document_path}`. For example: `projects/my-project/databases/my-database/documents` or `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom`", + "location": "path", + "pattern": "^projects/[^/]+/databases/[^/]+/documents/[^/]+/.*$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+parent}:runAggregationQuery", + "request": { + "$ref": "RunAggregationQueryRequest" + }, + "response": { + "$ref": "RunAggregationQueryResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/datastore" + ] + }, "runQuery": { "description": "Runs a query.", "flatPath": "v1beta1/projects/{projectsId}/databases/{databasesId}/documents/{documentsId}/{documentsId1}:runQuery", @@ -921,9 +950,38 @@ } } }, - "revision": "20220319", + "revision": "20220402", "rootUrl": "https://firestore.googleapis.com/", "schemas": { + "Aggregation": { + "description": "Defines a aggregation that produces a single result.", + "id": "Aggregation", + "properties": { + "alias": { + "description": "Required. The name of the field to store the result of the aggregation into. Requires: * Must be present. * Must be unique across all aggregation aliases. * Conform to existing document field name limitations.", + "type": "string" + }, + "count": { + "$ref": "Count", + "description": "Count aggregator." + } + }, + "type": "object" + }, + "AggregationResult": { + "description": "The result of a single bucket from a Firestore aggregation query. The keys of `aggregate_fields` are the same for all results in an aggregation query, unlike document queries which can have different fields present for each result.", + "id": "AggregationResult", + "properties": { + "aggregateFields": { + "additionalProperties": { + "$ref": "Value" + }, + "description": "The result of the aggregation functions, ex: `COUNT(*) AS total_docs`. The key is the alias assigned to the aggregation function on input and the size of this map equals the number of aggregation functions in the query.", + "type": "object" + } + }, + "type": "object" + }, "ArrayValue": { "description": "An array value.", "id": "ArrayValue", @@ -1118,7 +1176,7 @@ "id": "CompositeFilter", "properties": { "filters": { - "description": "The list of filters to combine. Must contain at least one filter.", + "description": "The list of filters to combine. Requires: * At least one filter is present.", "items": { "$ref": "Filter" }, @@ -1132,13 +1190,25 @@ ], "enumDescriptions": [ "Unspecified. This value must not be used.", - "The results are required to satisfy each of the combined filters." + "Documents are required to satisfy all of the combined filters." ], "type": "string" } }, "type": "object" }, + "Count": { + "description": "Count of documents that match the query. The `COUNT(*)` aggregation function operates on the entire document so it does not require a field reference.", + "id": "Count", + "properties": { + "upTo": { + "description": "Optional. Optional constraint on the maximum number of documents to count. This provides a way to set an upper bound on the number of documents to scan, limiting latency and cost. High-Level Example: ``` SELECT COUNT_UP_TO(1000) FROM ( SELECT * FROM k ); ``` Requires: * Must be greater than zero when present.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, "Cursor": { "description": "A position in a query result set.", "id": "Cursor", @@ -2093,6 +2163,52 @@ }, "type": "object" }, + "RunAggregationQueryRequest": { + "description": "The request for Firestore.RunAggregationQuery.", + "id": "RunAggregationQueryRequest", + "properties": { + "newTransaction": { + "$ref": "TransactionOptions", + "description": "Starts a new transaction as part of the query, defaulting to read-only. The new transaction ID will be returned as the first response in the stream." + }, + "readTime": { + "description": "Executes the query at the given timestamp. Requires: * Cannot be more than 270 seconds in the past.", + "format": "google-datetime", + "type": "string" + }, + "structuredAggregationQuery": { + "$ref": "StructuredAggregationQuery", + "description": "An aggregation query." + }, + "transaction": { + "description": "Run the aggregation within an already active transaction. The value here is the opaque transaction ID to execute the query in.", + "format": "byte", + "type": "string" + } + }, + "type": "object" + }, + "RunAggregationQueryResponse": { + "description": "The response for Firestore.RunAggregationQuery.", + "id": "RunAggregationQueryResponse", + "properties": { + "readTime": { + "description": "The time at which the aggregate value is valid for.", + "format": "google-datetime", + "type": "string" + }, + "result": { + "$ref": "AggregationResult", + "description": "A single aggregation result. Not present when reporting partial progress or when the query produced zero results." + }, + "transaction": { + "description": "The transaction that was started as part of this request. Only present on the first response when the request requested to start a new transaction.", + "format": "byte", + "type": "string" + } + }, + "type": "object" + }, "RunQueryRequest": { "description": "The request for Firestore.RunQuery.", "id": "RunQueryRequest", @@ -2126,10 +2242,6 @@ "$ref": "Document", "description": "A query result, not set when reporting partial progress." }, - "done": { - "description": "If present, Firestore has completely finished the request and no more documents will be returned.", - "type": "boolean" - }, "readTime": { "description": "The time at which the document was read. This may be monotonically increasing; in this case, the previous documents in the result stream are guaranteed not to have changed between their `read_time` and this one. If the query returns no results, a response with `read_time` and no `document` will be sent, and this represents the time at which the query was run.", "format": "google-datetime", @@ -2175,6 +2287,24 @@ }, "type": "object" }, + "StructuredAggregationQuery": { + "description": "Firestore query for running an aggregation over a StructuredQuery.", + "id": "StructuredAggregationQuery", + "properties": { + "aggregations": { + "description": "Optional. Series of aggregations to apply on top of the `structured_query`.", + "items": { + "$ref": "Aggregation" + }, + "type": "array" + }, + "structuredQuery": { + "$ref": "StructuredQuery", + "description": "Nested structured query." + } + }, + "type": "object" + }, "StructuredQuery": { "description": "A Firestore query.", "id": "StructuredQuery", diff --git a/firestore/v1beta1/firestore-gen.go b/firestore/v1beta1/firestore-gen.go index 518ee3d0c15..505c33fa82b 100644 --- a/firestore/v1beta1/firestore-gen.go +++ b/firestore/v1beta1/firestore-gen.go @@ -192,6 +192,75 @@ type ProjectsDatabasesIndexesService struct { s *Service } +// Aggregation: Defines a aggregation that produces a single result. +type Aggregation struct { + // Alias: Required. The name of the field to store the result of the + // aggregation into. Requires: * Must be present. * Must be unique + // across all aggregation aliases. * Conform to existing document field + // name limitations. + Alias string `json:"alias,omitempty"` + + // Count: Count aggregator. + Count *Count `json:"count,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Alias") 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. "Alias") 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 *Aggregation) MarshalJSON() ([]byte, error) { + type NoMethod Aggregation + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// AggregationResult: The result of a single bucket from a Firestore +// aggregation query. The keys of `aggregate_fields` are the same for +// all results in an aggregation query, unlike document queries which +// can have different fields present for each result. +type AggregationResult struct { + // AggregateFields: The result of the aggregation functions, ex: + // `COUNT(*) AS total_docs`. The key is the alias assigned to the + // aggregation function on input and the size of this map equals the + // number of aggregation functions in the query. + AggregateFields map[string]Value `json:"aggregateFields,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AggregateFields") 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. "AggregateFields") 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 *AggregationResult) MarshalJSON() ([]byte, error) { + type NoMethod AggregationResult + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // ArrayValue: An array value. type ArrayValue struct { // Values: Values in the array. @@ -561,15 +630,15 @@ func (s *CommitResponse) MarshalJSON() ([]byte, error) { // CompositeFilter: A filter that merges multiple other filters using // the given operator. type CompositeFilter struct { - // Filters: The list of filters to combine. Must contain at least one - // filter. + // Filters: The list of filters to combine. Requires: * At least one + // filter is present. Filters []*Filter `json:"filters,omitempty"` // Op: The operator for combining multiple filters. // // Possible values: // "OPERATOR_UNSPECIFIED" - Unspecified. This value must not be used. - // "AND" - The results are required to satisfy each of the combined + // "AND" - Documents are required to satisfy all of the combined // filters. Op string `json:"op,omitempty"` @@ -596,6 +665,40 @@ func (s *CompositeFilter) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// Count: Count of documents that match the query. The `COUNT(*)` +// aggregation function operates on the entire document so it does not +// require a field reference. +type Count struct { + // UpTo: Optional. Optional constraint on the maximum number of + // documents to count. This provides a way to set an upper bound on the + // number of documents to scan, limiting latency and cost. High-Level + // Example: ``` SELECT COUNT_UP_TO(1000) FROM ( SELECT * FROM k ); ``` + // Requires: * Must be greater than zero when present. + UpTo int64 `json:"upTo,omitempty"` + + // ForceSendFields is a list of field names (e.g. "UpTo") 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. "UpTo") 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 *Count) MarshalJSON() ([]byte, error) { + type NoMethod Count + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Cursor: A position in a query result set. type Cursor struct { // Before: If the position is just before or just after the given @@ -2323,6 +2426,92 @@ func (s *RollbackRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// RunAggregationQueryRequest: The request for +// Firestore.RunAggregationQuery. +type RunAggregationQueryRequest struct { + // NewTransaction: Starts a new transaction as part of the query, + // defaulting to read-only. The new transaction ID will be returned as + // the first response in the stream. + NewTransaction *TransactionOptions `json:"newTransaction,omitempty"` + + // ReadTime: Executes the query at the given timestamp. Requires: * + // Cannot be more than 270 seconds in the past. + ReadTime string `json:"readTime,omitempty"` + + // StructuredAggregationQuery: An aggregation query. + StructuredAggregationQuery *StructuredAggregationQuery `json:"structuredAggregationQuery,omitempty"` + + // Transaction: Run the aggregation within an already active + // transaction. The value here is the opaque transaction ID to execute + // the query in. + Transaction string `json:"transaction,omitempty"` + + // ForceSendFields is a list of field names (e.g. "NewTransaction") 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. "NewTransaction") 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 *RunAggregationQueryRequest) MarshalJSON() ([]byte, error) { + type NoMethod RunAggregationQueryRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// RunAggregationQueryResponse: The response for +// Firestore.RunAggregationQuery. +type RunAggregationQueryResponse struct { + // ReadTime: The time at which the aggregate value is valid for. + ReadTime string `json:"readTime,omitempty"` + + // Result: A single aggregation result. Not present when reporting + // partial progress or when the query produced zero results. + Result *AggregationResult `json:"result,omitempty"` + + // Transaction: The transaction that was started as part of this + // request. Only present on the first response when the request + // requested to start a new transaction. + Transaction string `json:"transaction,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "ReadTime") 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. "ReadTime") 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 *RunAggregationQueryResponse) MarshalJSON() ([]byte, error) { + type NoMethod RunAggregationQueryResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // RunQueryRequest: The request for Firestore.RunQuery. type RunQueryRequest struct { // NewTransaction: Starts a new transaction and reads the documents. @@ -2370,10 +2559,6 @@ type RunQueryResponse struct { // Document: A query result, not set when reporting partial progress. Document *Document `json:"document,omitempty"` - // Done: If present, Firestore has completely finished the request and - // no more documents will be returned. - Done bool `json:"done,omitempty"` - // ReadTime: The time at which the document was read. This may be // monotonically increasing; in this case, the previous documents in the // result stream are guaranteed not to have changed between their @@ -2463,6 +2648,39 @@ func (s *Status) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// StructuredAggregationQuery: Firestore query for running an +// aggregation over a StructuredQuery. +type StructuredAggregationQuery struct { + // Aggregations: Optional. Series of aggregations to apply on top of the + // `structured_query`. + Aggregations []*Aggregation `json:"aggregations,omitempty"` + + // StructuredQuery: Nested structured query. + StructuredQuery *StructuredQuery `json:"structuredQuery,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Aggregations") 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. "Aggregations") 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 *StructuredAggregationQuery) MarshalJSON() ([]byte, error) { + type NoMethod StructuredAggregationQuery + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // StructuredQuery: A Firestore query. type StructuredQuery struct { // EndAt: A end point for the query results. @@ -5799,6 +6017,160 @@ func (c *ProjectsDatabasesDocumentsRollbackCall) Do(opts ...googleapi.CallOption } +// method id "firestore.projects.databases.documents.runAggregationQuery": + +type ProjectsDatabasesDocumentsRunAggregationQueryCall struct { + s *Service + parent string + runaggregationqueryrequest *RunAggregationQueryRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// RunAggregationQuery: Runs an aggregation query. Rather than producing +// Document results like Firestore.RunQuery, this API allows running an +// aggregation to produce a series of AggregationResult server-side. +// High-Level Example: ``` -- Return the number of documents in table +// given a filter. SELECT COUNT(*) FROM ( SELECT * FROM k where a = true +// ); ``` +// +// - parent: The parent resource name. In the format: +// `projects/{project_id}/databases/{database_id}/documents` or +// `projects/{project_id}/databases/{database_id}/documents/{document_p +// ath}`. For example: +// `projects/my-project/databases/my-database/documents` or +// `projects/my-project/databases/my-database/documents/chatrooms/my-ch +// atroom`. +func (r *ProjectsDatabasesDocumentsService) RunAggregationQuery(parent string, runaggregationqueryrequest *RunAggregationQueryRequest) *ProjectsDatabasesDocumentsRunAggregationQueryCall { + c := &ProjectsDatabasesDocumentsRunAggregationQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.runaggregationqueryrequest = runaggregationqueryrequest + 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 *ProjectsDatabasesDocumentsRunAggregationQueryCall) Fields(s ...googleapi.Field) *ProjectsDatabasesDocumentsRunAggregationQueryCall { + 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 *ProjectsDatabasesDocumentsRunAggregationQueryCall) Context(ctx context.Context) *ProjectsDatabasesDocumentsRunAggregationQueryCall { + 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 *ProjectsDatabasesDocumentsRunAggregationQueryCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsDatabasesDocumentsRunAggregationQueryCall) 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.runaggregationqueryrequest) + 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, "v1beta1/{+parent}:runAggregationQuery") + 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 "firestore.projects.databases.documents.runAggregationQuery" call. +// Exactly one of *RunAggregationQueryResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *RunAggregationQueryResponse.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 *ProjectsDatabasesDocumentsRunAggregationQueryCall) Do(opts ...googleapi.CallOption) (*RunAggregationQueryResponse, 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 := &RunAggregationQueryResponse{ + 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": "Runs an aggregation query. Rather than producing Document results like Firestore.RunQuery, this API allows running an aggregation to produce a series of AggregationResult server-side. High-Level Example: ``` -- Return the number of documents in table given a filter. SELECT COUNT(*) FROM ( SELECT * FROM k where a = true ); ```", + // "flatPath": "v1beta1/projects/{projectsId}/databases/{databasesId}/documents/{documentsId}/{documentsId1}:runAggregationQuery", + // "httpMethod": "POST", + // "id": "firestore.projects.databases.documents.runAggregationQuery", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The parent resource name. In the format: `projects/{project_id}/databases/{database_id}/documents` or `projects/{project_id}/databases/{database_id}/documents/{document_path}`. For example: `projects/my-project/databases/my-database/documents` or `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom`", + // "location": "path", + // "pattern": "^projects/[^/]+/databases/[^/]+/documents/[^/]+/.*$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1beta1/{+parent}:runAggregationQuery", + // "request": { + // "$ref": "RunAggregationQueryRequest" + // }, + // "response": { + // "$ref": "RunAggregationQueryResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/datastore" + // ] + // } + +} + // method id "firestore.projects.databases.documents.runQuery": type ProjectsDatabasesDocumentsRunQueryCall struct { diff --git a/games/v1/games-api.json b/games/v1/games-api.json index ec9969758c6..d9e69d22fff 100644 --- a/games/v1/games-api.json +++ b/games/v1/games-api.json @@ -1229,7 +1229,7 @@ } } }, - "revision": "20220317", + "revision": "20220330", "rootUrl": "https://games.googleapis.com/", "schemas": { "AchievementDefinition": { @@ -2430,6 +2430,10 @@ ], "type": "string" }, + "gamePlayerId": { + "description": "Per-application unique player identifier.", + "type": "string" + }, "kind": { "description": "Uniquely identifies the type of this resource. Value is always the fixed string `games#player`", "type": "string" diff --git a/games/v1/games-gen.go b/games/v1/games-gen.go index ec0a0483875..a2d60e91f01 100644 --- a/games/v1/games-gen.go +++ b/games/v1/games-gen.go @@ -2045,6 +2045,9 @@ type Player struct { // "FRIEND" - The player and requester are friends. FriendStatus string `json:"friendStatus,omitempty"` + // GamePlayerId: Per-application unique player identifier. + GamePlayerId string `json:"gamePlayerId,omitempty"` + // Kind: Uniquely identifies the type of this resource. Value is always // the fixed string `games#player` Kind string `json:"kind,omitempty"` diff --git a/gmail/v1/gmail-api.json b/gmail/v1/gmail-api.json index 336e2a7891b..ce704e4916b 100644 --- a/gmail/v1/gmail-api.json +++ b/gmail/v1/gmail-api.json @@ -1788,7 +1788,7 @@ ] }, "delete": { - "description": "Deletes a filter.", + "description": "Immediately and permanently deletes the specified filter.", "flatPath": "gmail/v1/users/{userId}/settings/filters/{id}", "httpMethod": "DELETE", "id": "gmail.users.settings.filters.delete", @@ -2682,7 +2682,7 @@ } } }, - "revision": "20220307", + "revision": "20220404", "rootUrl": "https://gmail.googleapis.com/", "schemas": { "AutoForwarding": { diff --git a/gmail/v1/gmail-gen.go b/gmail/v1/gmail-gen.go index 5c05ece23df..0ff03b91433 100644 --- a/gmail/v1/gmail-gen.go +++ b/gmail/v1/gmail-gen.go @@ -9527,7 +9527,7 @@ type UsersSettingsFiltersDeleteCall struct { header_ http.Header } -// Delete: Deletes a filter. +// Delete: Immediately and permanently deletes the specified filter. // // - id: The ID of the filter to be deleted. // - userId: User's email address. The special value "me" can be used to @@ -9601,7 +9601,7 @@ func (c *UsersSettingsFiltersDeleteCall) Do(opts ...googleapi.CallOption) error } return nil // { - // "description": "Deletes a filter.", + // "description": "Immediately and permanently deletes the specified filter.", // "flatPath": "gmail/v1/users/{userId}/settings/filters/{id}", // "httpMethod": "DELETE", // "id": "gmail.users.settings.filters.delete", diff --git a/logging/v2/logging-api.json b/logging/v2/logging-api.json index c59704c8251..d69542ba3fa 100644 --- a/logging/v2/logging-api.json +++ b/logging/v2/logging-api.json @@ -5817,7 +5817,7 @@ } } }, - "revision": "20220318", + "revision": "20220401", "rootUrl": "https://logging.googleapis.com/", "schemas": { "BigQueryOptions": { @@ -6088,6 +6088,37 @@ }, "type": "object" }, + "IndexConfig": { + "description": "Configuration for an indexed field.", + "id": "IndexConfig", + "properties": { + "createTime": { + "description": "Output only. The timestamp when the index was last modified.This is used to return the timestamp, and will be ignored if supplied during update.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "fieldPath": { + "description": "Required. The LogEntry field path to index.Note that some paths are automatically indexed, and other paths are not eligible for indexing. See indexing documentation( https://cloud.google.com/logging/docs/view/advanced-queries#indexed-fields) for details.For example: jsonPayload.request.status", + "type": "string" + }, + "type": { + "description": "Required. The type of data in this index.", + "enum": [ + "INDEX_TYPE_UNSPECIFIED", + "INDEX_TYPE_STRING", + "INDEX_TYPE_INTEGER" + ], + "enumDescriptions": [ + "The index's type is unspecified.", + "The index is a string-type index.", + "The index is a integer-type index." + ], + "type": "string" + } + }, + "type": "object" + }, "LabelDescriptor": { "description": "A description of a label.", "id": "LabelDescriptor", @@ -6409,6 +6440,13 @@ "description": "Describes this bucket.", "type": "string" }, + "indexConfigs": { + "description": "A list of indexed fields and related configuration data.", + "items": { + "$ref": "IndexConfig" + }, + "type": "array" + }, "lifecycleState": { "description": "Output only. The bucket lifecycle state.", "enum": [ diff --git a/logging/v2/logging-gen.go b/logging/v2/logging-gen.go index 8d6a3492d1a..dd0568de666 100644 --- a/logging/v2/logging-gen.go +++ b/logging/v2/logging-gen.go @@ -1219,6 +1219,51 @@ func (s *HttpRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// IndexConfig: Configuration for an indexed field. +type IndexConfig struct { + // CreateTime: Output only. The timestamp when the index was last + // modified.This is used to return the timestamp, and will be ignored if + // supplied during update. + CreateTime string `json:"createTime,omitempty"` + + // FieldPath: Required. The LogEntry field path to index.Note that some + // paths are automatically indexed, and other paths are not eligible for + // indexing. See indexing documentation( + // https://cloud.google.com/logging/docs/view/advanced-queries#indexed-fields) + // for details.For example: jsonPayload.request.status + FieldPath string `json:"fieldPath,omitempty"` + + // Type: Required. The type of data in this index. + // + // Possible values: + // "INDEX_TYPE_UNSPECIFIED" - The index's type is unspecified. + // "INDEX_TYPE_STRING" - The index is a string-type index. + // "INDEX_TYPE_INTEGER" - The index is a integer-type index. + Type string `json:"type,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with + // empty or 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 *IndexConfig) MarshalJSON() ([]byte, error) { + type NoMethod IndexConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // LabelDescriptor: A description of a label. type LabelDescriptor struct { // Description: A human-readable description for the label. @@ -1847,6 +1892,10 @@ type LogBucket struct { // Description: Describes this bucket. Description string `json:"description,omitempty"` + // IndexConfigs: A list of indexed fields and related configuration + // data. + IndexConfigs []*IndexConfig `json:"indexConfigs,omitempty"` + // LifecycleState: Output only. The bucket lifecycle state. // // Possible values: diff --git a/networkconnectivity/v1/networkconnectivity-api.json b/networkconnectivity/v1/networkconnectivity-api.json index ec6d88ed8cb..9ef51317114 100644 --- a/networkconnectivity/v1/networkconnectivity-api.json +++ b/networkconnectivity/v1/networkconnectivity-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" }, @@ -938,7 +938,7 @@ } } }, - "revision": "20220321", + "revision": "20220404", "rootUrl": "https://networkconnectivity.googleapis.com/", "schemas": { "AuditConfig": { @@ -998,7 +998,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" }, @@ -1481,7 +1481,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\"`", @@ -1568,7 +1568,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/networkconnectivity/v1/networkconnectivity-gen.go b/networkconnectivity/v1/networkconnectivity-gen.go index bf286e88869..4cfee9740a4 100644 --- a/networkconnectivity/v1/networkconnectivity-gen.go +++ b/networkconnectivity/v1/networkconnectivity-gen.go @@ -327,8 +327,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 @@ -1239,7 +1239,7 @@ func (s *RoutingVPC) 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"` @@ -1357,7 +1357,7 @@ func (s *Spoke) 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"` @@ -1589,8 +1589,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 @@ -1719,7 +1719,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/policysimulator/v1/policysimulator-api.json b/policysimulator/v1/policysimulator-api.json index f80ff9d49fe..eefa0ddb293 100644 --- a/policysimulator/v1/policysimulator-api.json +++ b/policysimulator/v1/policysimulator-api.json @@ -493,7 +493,7 @@ } } }, - "revision": "20220305", + "revision": "20220402", "rootUrl": "https://policysimulator.googleapis.com/", "schemas": { "GoogleCloudPolicysimulatorV1AccessStateDiff": { @@ -1111,7 +1111,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" }, diff --git a/policysimulator/v1/policysimulator-gen.go b/policysimulator/v1/policysimulator-gen.go index f2165241976..bae0cc93735 100644 --- a/policysimulator/v1/policysimulator-gen.go +++ b/policysimulator/v1/policysimulator-gen.go @@ -1312,8 +1312,8 @@ type GoogleIamV1Binding struct { // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *GoogleTypeExpr `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 diff --git a/policysimulator/v1beta1/policysimulator-api.json b/policysimulator/v1beta1/policysimulator-api.json index d9c882c65b2..5cd0ce9ed24 100644 --- a/policysimulator/v1beta1/policysimulator-api.json +++ b/policysimulator/v1beta1/policysimulator-api.json @@ -493,7 +493,7 @@ } } }, - "revision": "20220305", + "revision": "20220402", "rootUrl": "https://policysimulator.googleapis.com/", "schemas": { "GoogleCloudPolicysimulatorV1Replay": { @@ -1111,7 +1111,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" }, diff --git a/policysimulator/v1beta1/policysimulator-gen.go b/policysimulator/v1beta1/policysimulator-gen.go index 9e29ae505e8..29e82c8971a 100644 --- a/policysimulator/v1beta1/policysimulator-gen.go +++ b/policysimulator/v1beta1/policysimulator-gen.go @@ -1313,8 +1313,8 @@ type GoogleIamV1Binding struct { // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *GoogleTypeExpr `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 diff --git a/policytroubleshooter/v1/policytroubleshooter-api.json b/policytroubleshooter/v1/policytroubleshooter-api.json index 602cc4e5453..a0360864cc5 100644 --- a/policytroubleshooter/v1/policytroubleshooter-api.json +++ b/policytroubleshooter/v1/policytroubleshooter-api.json @@ -128,7 +128,7 @@ } } }, - "revision": "20211015", + "revision": "20220402", "rootUrl": "https://policytroubleshooter.googleapis.com/", "schemas": { "GoogleCloudPolicytroubleshooterV1AccessTuple": { @@ -427,7 +427,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" }, diff --git a/policytroubleshooter/v1/policytroubleshooter-gen.go b/policytroubleshooter/v1/policytroubleshooter-gen.go index de38a0c184d..de67ebf64ab 100644 --- a/policytroubleshooter/v1/policytroubleshooter-gen.go +++ b/policytroubleshooter/v1/policytroubleshooter-gen.go @@ -641,8 +641,8 @@ type GoogleIamV1Binding struct { // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *GoogleTypeExpr `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 diff --git a/policytroubleshooter/v1beta/policytroubleshooter-api.json b/policytroubleshooter/v1beta/policytroubleshooter-api.json index 688aaa33de5..3702ead0997 100644 --- a/policytroubleshooter/v1beta/policytroubleshooter-api.json +++ b/policytroubleshooter/v1beta/policytroubleshooter-api.json @@ -128,7 +128,7 @@ } } }, - "revision": "20211015", + "revision": "20220402", "rootUrl": "https://policytroubleshooter.googleapis.com/", "schemas": { "GoogleCloudPolicytroubleshooterV1betaAccessTuple": { @@ -427,7 +427,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" }, diff --git a/policytroubleshooter/v1beta/policytroubleshooter-gen.go b/policytroubleshooter/v1beta/policytroubleshooter-gen.go index 0d3a1ec3491..f190ad5a163 100644 --- a/policytroubleshooter/v1beta/policytroubleshooter-gen.go +++ b/policytroubleshooter/v1beta/policytroubleshooter-gen.go @@ -633,8 +633,8 @@ type GoogleIamV1Binding struct { // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *GoogleTypeExpr `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 diff --git a/privateca/v1/privateca-api.json b/privateca/v1/privateca-api.json index d7699df06a3..2c0b6da08d6 100644 --- a/privateca/v1/privateca-api.json +++ b/privateca/v1/privateca-api.json @@ -1595,7 +1595,7 @@ } } }, - "revision": "20220309", + "revision": "20220323", "rootUrl": "https://privateca.googleapis.com/", "schemas": { "AccessUrls": { @@ -2309,7 +2309,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/privateca/v1/privateca-gen.go b/privateca/v1/privateca-gen.go index b82118284b0..3aca202b924 100644 --- a/privateca/v1/privateca-gen.go +++ b/privateca/v1/privateca-gen.go @@ -1376,8 +1376,7 @@ func (s *EcKeyType) 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. diff --git a/privateca/v1beta1/privateca-api.json b/privateca/v1beta1/privateca-api.json index 7e28c3bd8c5..0828ef9abe7 100644 --- a/privateca/v1beta1/privateca-api.json +++ b/privateca/v1beta1/privateca-api.json @@ -1254,7 +1254,7 @@ } } }, - "revision": "20211103", + "revision": "20220323", "rootUrl": "https://privateca.googleapis.com/", "schemas": { "AccessUrls": { @@ -1839,7 +1839,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/privateca/v1beta1/privateca-gen.go b/privateca/v1beta1/privateca-gen.go index 84b9741e991..953c7749230 100644 --- a/privateca/v1beta1/privateca-gen.go +++ b/privateca/v1beta1/privateca-gen.go @@ -1139,8 +1139,7 @@ func (s *DisableCertificateAuthorityRequest) 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. diff --git a/redis/v1/redis-api.json b/redis/v1/redis-api.json index 023021f7e4b..5a9c979a942 100644 --- a/redis/v1/redis-api.json +++ b/redis/v1/redis-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" }, @@ -624,11 +624,11 @@ } } }, - "revision": "20220301", + "revision": "20220331", "rootUrl": "https://redis.googleapis.com/", "schemas": { "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/redis/v1/redis-gen.go b/redis/v1/redis-gen.go index f36220c65e9..e940f98b041 100644 --- a/redis/v1/redis-gen.go +++ b/redis/v1/redis-gen.go @@ -188,8 +188,7 @@ type ProjectsLocationsOperationsService struct { // 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. @@ -1604,8 +1603,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 @@ -1734,7 +1733,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/redis/v1beta1/redis-api.json b/redis/v1beta1/redis-api.json index 9766a89b1de..ef997652f5e 100644 --- a/redis/v1beta1/redis-api.json +++ b/redis/v1beta1/redis-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" }, @@ -624,7 +624,7 @@ } } }, - "revision": "20220325", + "revision": "20220331", "rootUrl": "https://redis.googleapis.com/", "schemas": { "Empty": { diff --git a/redis/v1beta1/redis-gen.go b/redis/v1beta1/redis-gen.go index 86e02c0c9b9..7520ff9562a 100644 --- a/redis/v1beta1/redis-gen.go +++ b/redis/v1beta1/redis-gen.go @@ -1608,8 +1608,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 @@ -1738,7 +1738,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/run/v1/run-api.json b/run/v1/run-api.json index d3c6bd49558..33b13ebcc65 100644 --- a/run/v1/run-api.json +++ b/run/v1/run-api.json @@ -254,7 +254,7 @@ "type": "string" }, "parent": { - "description": "The namespace in which the domain mapping should be created. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The namespace in which the domain mapping should be created. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+$", "required": true, @@ -297,7 +297,7 @@ "type": "string" }, "name": { - "description": "The name of the domain mapping to delete. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The name of the domain mapping to delete. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+/domainmappings/[^/]+$", "required": true, @@ -327,7 +327,7 @@ ], "parameters": { "name": { - "description": "The name of the domain mapping to retrieve. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The name of the domain mapping to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+/domainmappings/[^/]+$", "required": true, @@ -378,7 +378,7 @@ "type": "integer" }, "parent": { - "description": "The namespace from which the domain mappings should be listed. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The namespace from which the domain mappings should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+$", "required": true, @@ -427,7 +427,7 @@ "type": "string" }, "name": { - "description": "Required. The name of the execution to delete. Replace {namespace_id} with the project ID or number.", + "description": "Required. The name of the execution to delete. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+/executions/[^/]+$", "required": true, @@ -457,7 +457,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the execution to retrieve. Replace {namespace_id} with the project ID or number.", + "description": "Required. The name of the execution to retrieve. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+/executions/[^/]+$", "required": true, @@ -508,7 +508,7 @@ "type": "integer" }, "parent": { - "description": "Required. The namespace from which the executions should be listed. Replace {namespace_id} with the project ID or number.", + "description": "Required. The namespace from which the executions should be listed. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+$", "required": true, @@ -547,7 +547,7 @@ ], "parameters": { "parent": { - "description": "Required. The namespace in which the job should be created. Replace {namespace_id} with the project ID or number.", + "description": "Required. The namespace in which the job should be created. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+$", "required": true, @@ -585,7 +585,7 @@ "type": "string" }, "name": { - "description": "Required. The name of the job to delete. Replace {namespace_id} with the project ID or number.", + "description": "Required. The name of the job to delete. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+/jobs/[^/]+$", "required": true, @@ -615,7 +615,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the job to retrieve. Replace {namespace_id} with the project ID or number.", + "description": "Required. The name of the job to retrieve. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+/jobs/[^/]+$", "required": true, @@ -666,7 +666,7 @@ "type": "integer" }, "parent": { - "description": "Required. The namespace from which the jobs should be listed. Replace {namespace_id} with the project ID or number.", + "description": "Required. The namespace from which the jobs should be listed. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+$", "required": true, @@ -701,7 +701,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the service being replaced. Replace {namespace_id} with the project ID or number.", + "description": "Required. The name of the service being replaced. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+/jobs/[^/]+$", "required": true, @@ -729,7 +729,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the job to run. Replace {namespace_id} with the project ID or number.", + "description": "Required. The name of the job to run. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+/jobs/[^/]+$", "required": true, @@ -776,7 +776,7 @@ "type": "string" }, "name": { - "description": "The name of the revision to delete. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The name of the revision to delete. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+/revisions/[^/]+$", "required": true, @@ -806,7 +806,7 @@ ], "parameters": { "name": { - "description": "The name of the revision to retrieve. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The name of the revision to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+/revisions/[^/]+$", "required": true, @@ -857,7 +857,7 @@ "type": "integer" }, "parent": { - "description": "The namespace from which the revisions should be listed. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The namespace from which the revisions should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+$", "required": true, @@ -896,7 +896,7 @@ ], "parameters": { "name": { - "description": "The name of the route to retrieve. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The name of the route to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+/routes/[^/]+$", "required": true, @@ -947,7 +947,7 @@ "type": "integer" }, "parent": { - "description": "The namespace from which the routes should be listed. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The namespace from which the routes should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+$", "required": true, @@ -986,12 +986,12 @@ ], "parameters": { "dryRun": { - "description": "Indicates that the server should validate the request and populate default values without persisting the request. Supported values: `all`", + "description": "Indicates that the server should validate the request and populate default values without persisting the request. Supported values: `all` LINT.ThenChange(//depot/google3/google/cloud/serverless/v1/internal_service.proto:create_internal_service_request)", "location": "query", "type": "string" }, "parent": { - "description": "The namespace in which the service should be created. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "LINT.IfChange() The namespace in which the service should be created. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+$", "required": true, @@ -1034,7 +1034,7 @@ "type": "string" }, "name": { - "description": "The name of the service to delete. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The name of the service to delete. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+/services/[^/]+$", "required": true, @@ -1064,7 +1064,7 @@ ], "parameters": { "name": { - "description": "The name of the service to retrieve. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The name of the service to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+/services/[^/]+$", "required": true, @@ -1115,7 +1115,7 @@ "type": "integer" }, "parent": { - "description": "The namespace from which the services should be listed. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The namespace from which the services should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+$", "required": true, @@ -1150,12 +1150,12 @@ ], "parameters": { "dryRun": { - "description": "Indicates that the server should validate the request and populate default values without persisting the request. Supported values: `all`", + "description": "Indicates that the server should validate the request and populate default values without persisting the request. Supported values: `all` LINT.ThenChange(//depot/google3/google/cloud/serverless/v1/internal_service.proto:replace_internal_service_request)", "location": "query", "type": "string" }, "name": { - "description": "The name of the service being replaced. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "LINT.IfChange() The name of the service being replaced. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+/services/[^/]+$", "required": true, @@ -1187,7 +1187,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the task to retrieve. Replace {namespace_id} with the project ID or number.", + "description": "Required. The name of the task to retrieve. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+/tasks/[^/]+$", "required": true, @@ -1238,7 +1238,7 @@ "type": "integer" }, "parent": { - "description": "Required. The namespace from which the tasks should be listed. Replace {namespace_id} with the project ID or number.", + "description": "Required. The namespace from which the tasks should be listed. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^namespaces/[^/]+$", "required": true, @@ -1321,7 +1321,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" }, @@ -1501,7 +1501,7 @@ "type": "string" }, "parent": { - "description": "The namespace in which the domain mapping should be created. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The namespace in which the domain mapping should be created. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -1544,7 +1544,7 @@ "type": "string" }, "name": { - "description": "The name of the domain mapping to delete. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The name of the domain mapping to delete. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/domainmappings/[^/]+$", "required": true, @@ -1574,7 +1574,7 @@ ], "parameters": { "name": { - "description": "The name of the domain mapping to retrieve. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The name of the domain mapping to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/domainmappings/[^/]+$", "required": true, @@ -1625,7 +1625,7 @@ "type": "integer" }, "parent": { - "description": "The namespace from which the domain mappings should be listed. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The namespace from which the domain mappings should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -1770,7 +1770,7 @@ "type": "string" }, "name": { - "description": "The name of the revision to delete. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The name of the revision to delete. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/revisions/[^/]+$", "required": true, @@ -1800,7 +1800,7 @@ ], "parameters": { "name": { - "description": "The name of the revision to retrieve. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The name of the revision to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/revisions/[^/]+$", "required": true, @@ -1851,7 +1851,7 @@ "type": "integer" }, "parent": { - "description": "The namespace from which the revisions should be listed. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The namespace from which the revisions should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -1890,7 +1890,7 @@ ], "parameters": { "name": { - "description": "The name of the route to retrieve. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The name of the route to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/routes/[^/]+$", "required": true, @@ -1941,7 +1941,7 @@ "type": "integer" }, "parent": { - "description": "The namespace from which the routes should be listed. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The namespace from which the routes should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -1980,12 +1980,12 @@ ], "parameters": { "dryRun": { - "description": "Indicates that the server should validate the request and populate default values without persisting the request. Supported values: `all`", + "description": "Indicates that the server should validate the request and populate default values without persisting the request. Supported values: `all` LINT.ThenChange(//depot/google3/google/cloud/serverless/v1/internal_service.proto:create_internal_service_request)", "location": "query", "type": "string" }, "parent": { - "description": "The namespace in which the service should be created. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "LINT.IfChange() The namespace in which the service should be created. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -2028,7 +2028,7 @@ "type": "string" }, "name": { - "description": "The name of the service to delete. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The name of the service to delete. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", "required": true, @@ -2058,7 +2058,7 @@ ], "parameters": { "name": { - "description": "The name of the service to retrieve. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The name of the service to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", "required": true, @@ -2140,7 +2140,7 @@ "type": "integer" }, "parent": { - "description": "The namespace from which the services should be listed. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "The namespace from which the services should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -2175,12 +2175,12 @@ ], "parameters": { "dryRun": { - "description": "Indicates that the server should validate the request and populate default values without persisting the request. Supported values: `all`", + "description": "Indicates that the server should validate the request and populate default values without persisting the request. Supported values: `all` LINT.ThenChange(//depot/google3/google/cloud/serverless/v1/internal_service.proto:replace_internal_service_request)", "location": "query", "type": "string" }, "name": { - "description": "The name of the service being replaced. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + "description": "LINT.IfChange() The name of the service being replaced. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", "required": true, @@ -2261,7 +2261,7 @@ } } }, - "revision": "20220318", + "revision": "20220401", "rootUrl": "https://run.googleapis.com/", "schemas": { "Addressable": { @@ -2826,7 +2826,7 @@ "id": "ExecutionSpec", "properties": { "parallelism": { - "description": "Optional. Specifies the maximum desired number of tasks the execution should run at any given time. Must be \u003c= task_count. If not specified, defaults to -1. When the job is run, this field is passed to the execution, and if -1 it will be set to the maximum possible value. The actual number of tasks running in steady state will be less than this number when there are fewer tasks waiting to be completed remaining, i.e. when the work left to do is less than max parallelism. +optional", + "description": "Optional. Specifies the maximum desired number of tasks the execution should run at given time. Must be \u003c= task_count. When the job is run, if this field is 0 or unset, the maximum possible value will be used for that execution. The actual number of tasks running in steady state will be less than this number when there are fewer tasks waiting to be completed remaining, i.e. when the work left to do is less than max parallelism. +optional", "format": "int32", "type": "integer" }, diff --git a/run/v1/run-gen.go b/run/v1/run-gen.go index 2e3da2b24ad..cfbb1e1e4cb 100644 --- a/run/v1/run-gen.go +++ b/run/v1/run-gen.go @@ -1482,13 +1482,12 @@ func (s *ExecutionReference) MarshalJSON() ([]byte, error) { // ExecutionSpec: ExecutionSpec describes how the execution will look. type ExecutionSpec struct { // Parallelism: Optional. Specifies the maximum desired number of tasks - // the execution should run at any given time. Must be <= task_count. If - // not specified, defaults to -1. When the job is run, this field is - // passed to the execution, and if -1 it will be set to the maximum - // possible value. The actual number of tasks running in steady state - // will be less than this number when there are fewer tasks waiting to - // be completed remaining, i.e. when the work left to do is less than - // max parallelism. +optional + // the execution should run at given time. Must be <= task_count. When + // the job is run, if this field is 0 or unset, the maximum possible + // value will be used for that execution. The actual number of tasks + // running in steady state will be less than this number when there are + // fewer tasks waiting to be completed remaining, i.e. when the work + // left to do is less than max parallelism. +optional Parallelism int64 `json:"parallelism,omitempty"` // TaskCount: Optional. Specifies the desired number of tasks the @@ -5119,8 +5118,9 @@ type NamespacesDomainmappingsCreateCall struct { // Create: Create a new domain mapping. // // - parent: The namespace in which the domain mapping should be -// created. For Cloud Run (fully managed), replace {namespace_id} with -// the project ID or number. +// created. For Cloud Run (fully managed), replace {namespace} with +// the project ID or number. It takes the form namespaces/{namespace}. +// For example: namespaces/PROJECT_ID. func (r *NamespacesDomainmappingsService) Create(parent string, domainmapping *DomainMapping) *NamespacesDomainmappingsCreateCall { c := &NamespacesDomainmappingsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -5241,7 +5241,7 @@ func (c *NamespacesDomainmappingsCreateCall) Do(opts ...googleapi.CallOption) (* // "type": "string" // }, // "parent": { - // "description": "The namespace in which the domain mapping should be created. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The namespace in which the domain mapping should be created. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+$", // "required": true, @@ -5275,8 +5275,9 @@ type NamespacesDomainmappingsDeleteCall struct { // Delete: Delete a domain mapping. // // - name: The name of the domain mapping to delete. For Cloud Run -// (fully managed), replace {namespace_id} with the project ID or -// number. +// (fully managed), replace {namespace} with the project ID or number. +// It takes the form namespaces/{namespace}. For example: +// namespaces/PROJECT_ID. func (r *NamespacesDomainmappingsService) Delete(name string) *NamespacesDomainmappingsDeleteCall { c := &NamespacesDomainmappingsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -5425,7 +5426,7 @@ func (c *NamespacesDomainmappingsDeleteCall) Do(opts ...googleapi.CallOption) (* // "type": "string" // }, // "name": { - // "description": "The name of the domain mapping to delete. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The name of the domain mapping to delete. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+/domainmappings/[^/]+$", // "required": true, @@ -5462,8 +5463,9 @@ type NamespacesDomainmappingsGetCall struct { // Get: Get information about a domain mapping. // // - name: The name of the domain mapping to retrieve. For Cloud Run -// (fully managed), replace {namespace_id} with the project ID or -// number. +// (fully managed), replace {namespace} with the project ID or number. +// It takes the form namespaces/{namespace}. For example: +// namespaces/PROJECT_ID. func (r *NamespacesDomainmappingsService) Get(name string) *NamespacesDomainmappingsGetCall { c := &NamespacesDomainmappingsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -5578,7 +5580,7 @@ func (c *NamespacesDomainmappingsGetCall) Do(opts ...googleapi.CallOption) (*Dom // ], // "parameters": { // "name": { - // "description": "The name of the domain mapping to retrieve. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The name of the domain mapping to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+/domainmappings/[^/]+$", // "required": true, @@ -5610,8 +5612,9 @@ type NamespacesDomainmappingsListCall struct { // List: List domain mappings. // // - parent: The namespace from which the domain mappings should be -// listed. For Cloud Run (fully managed), replace {namespace_id} with -// the project ID or number. +// listed. For Cloud Run (fully managed), replace {namespace} with the +// project ID or number. It takes the form namespaces/{namespace}. For +// example: namespaces/PROJECT_ID. func (r *NamespacesDomainmappingsService) List(parent string) *NamespacesDomainmappingsListCall { c := &NamespacesDomainmappingsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -5806,7 +5809,7 @@ func (c *NamespacesDomainmappingsListCall) Do(opts ...googleapi.CallOption) (*Li // "type": "integer" // }, // "parent": { - // "description": "The namespace from which the domain mappings should be listed. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The namespace from which the domain mappings should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+$", // "required": true, @@ -5846,8 +5849,9 @@ type NamespacesExecutionsDeleteCall struct { // Delete: Delete an execution. // -// - name: The name of the execution to delete. Replace {namespace_id} -// with the project ID or number. +// - name: The name of the execution to delete. Replace {namespace} with +// the project ID or number. It takes the form namespaces/{namespace}. +// For example: namespaces/PROJECT_ID. func (r *NamespacesExecutionsService) Delete(name string) *NamespacesExecutionsDeleteCall { c := &NamespacesExecutionsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -5983,7 +5987,7 @@ func (c *NamespacesExecutionsDeleteCall) Do(opts ...googleapi.CallOption) (*Stat // "type": "string" // }, // "name": { - // "description": "Required. The name of the execution to delete. Replace {namespace_id} with the project ID or number.", + // "description": "Required. The name of the execution to delete. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+/executions/[^/]+$", // "required": true, @@ -6019,8 +6023,9 @@ type NamespacesExecutionsGetCall struct { // Get: Get information about an execution. // -// - name: The name of the execution to retrieve. Replace {namespace_id} -// with the project ID or number. +// - name: The name of the execution to retrieve. Replace {namespace} +// with the project ID or number. It takes the form +// namespaces/{namespace}. For example: namespaces/PROJECT_ID. func (r *NamespacesExecutionsService) Get(name string) *NamespacesExecutionsGetCall { c := &NamespacesExecutionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -6135,7 +6140,7 @@ func (c *NamespacesExecutionsGetCall) Do(opts ...googleapi.CallOption) (*Executi // ], // "parameters": { // "name": { - // "description": "Required. The name of the execution to retrieve. Replace {namespace_id} with the project ID or number.", + // "description": "Required. The name of the execution to retrieve. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+/executions/[^/]+$", // "required": true, @@ -6167,7 +6172,8 @@ type NamespacesExecutionsListCall struct { // List: List executions. // // - parent: The namespace from which the executions should be listed. -// Replace {namespace_id} with the project ID or number. +// Replace {namespace} with the project ID or number. It takes the +// form namespaces/{namespace}. For example: namespaces/PROJECT_ID. func (r *NamespacesExecutionsService) List(parent string) *NamespacesExecutionsListCall { c := &NamespacesExecutionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6362,7 +6368,7 @@ func (c *NamespacesExecutionsListCall) Do(opts ...googleapi.CallOption) (*ListEx // "type": "integer" // }, // "parent": { - // "description": "Required. The namespace from which the executions should be listed. Replace {namespace_id} with the project ID or number.", + // "description": "Required. The namespace from which the executions should be listed. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+$", // "required": true, @@ -6404,7 +6410,8 @@ type NamespacesJobsCreateCall struct { // Create: Create a job. // // - parent: The namespace in which the job should be created. Replace -// {namespace_id} with the project ID or number. +// {namespace} with the project ID or number. It takes the form +// namespaces/{namespace}. For example: namespaces/PROJECT_ID. func (r *NamespacesJobsService) Create(parent string, job *Job) *NamespacesJobsCreateCall { c := &NamespacesJobsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -6512,7 +6519,7 @@ func (c *NamespacesJobsCreateCall) Do(opts ...googleapi.CallOption) (*Job, error // ], // "parameters": { // "parent": { - // "description": "Required. The namespace in which the job should be created. Replace {namespace_id} with the project ID or number.", + // "description": "Required. The namespace in which the job should be created. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+$", // "required": true, @@ -6545,8 +6552,9 @@ type NamespacesJobsDeleteCall struct { // Delete: Delete a job. // -// - name: The name of the job to delete. Replace {namespace_id} with -// the project ID or number. +// - name: The name of the job to delete. Replace {namespace} with the +// project ID or number. It takes the form namespaces/{namespace}. For +// example: namespaces/PROJECT_ID. func (r *NamespacesJobsService) Delete(name string) *NamespacesJobsDeleteCall { c := &NamespacesJobsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -6682,7 +6690,7 @@ func (c *NamespacesJobsDeleteCall) Do(opts ...googleapi.CallOption) (*Status, er // "type": "string" // }, // "name": { - // "description": "Required. The name of the job to delete. Replace {namespace_id} with the project ID or number.", + // "description": "Required. The name of the job to delete. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+/jobs/[^/]+$", // "required": true, @@ -6718,8 +6726,9 @@ type NamespacesJobsGetCall struct { // Get: Get information about a job. // -// - name: The name of the job to retrieve. Replace {namespace_id} with -// the project ID or number. +// - name: The name of the job to retrieve. Replace {namespace} with the +// project ID or number. It takes the form namespaces/{namespace}. For +// example: namespaces/PROJECT_ID. func (r *NamespacesJobsService) Get(name string) *NamespacesJobsGetCall { c := &NamespacesJobsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -6834,7 +6843,7 @@ func (c *NamespacesJobsGetCall) Do(opts ...googleapi.CallOption) (*Job, error) { // ], // "parameters": { // "name": { - // "description": "Required. The name of the job to retrieve. Replace {namespace_id} with the project ID or number.", + // "description": "Required. The name of the job to retrieve. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+/jobs/[^/]+$", // "required": true, @@ -6866,7 +6875,8 @@ type NamespacesJobsListCall struct { // List: List jobs. // // - parent: The namespace from which the jobs should be listed. Replace -// {namespace_id} with the project ID or number. +// {namespace} with the project ID or number. It takes the form +// namespaces/{namespace}. For example: namespaces/PROJECT_ID. func (r *NamespacesJobsService) List(parent string) *NamespacesJobsListCall { c := &NamespacesJobsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7061,7 +7071,7 @@ func (c *NamespacesJobsListCall) Do(opts ...googleapi.CallOption) (*ListJobsResp // "type": "integer" // }, // "parent": { - // "description": "Required. The namespace from which the jobs should be listed. Replace {namespace_id} with the project ID or number.", + // "description": "Required. The namespace from which the jobs should be listed. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+$", // "required": true, @@ -7106,8 +7116,9 @@ type NamespacesJobsReplaceJobCall struct { // metadata.resourceVersion to enforce update from last read for // optimistic concurrency control. // -// - name: The name of the service being replaced. Replace -// {namespace_id} with the project ID or number. +// - name: The name of the service being replaced. Replace {namespace} +// with the project ID or number. It takes the form +// namespaces/{namespace}. For example: namespaces/PROJECT_ID. func (r *NamespacesJobsService) ReplaceJob(name string, job *Job) *NamespacesJobsReplaceJobCall { c := &NamespacesJobsReplaceJobCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -7215,7 +7226,7 @@ func (c *NamespacesJobsReplaceJobCall) Do(opts ...googleapi.CallOption) (*Job, e // ], // "parameters": { // "name": { - // "description": "Required. The name of the service being replaced. Replace {namespace_id} with the project ID or number.", + // "description": "Required. The name of the service being replaced. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+/jobs/[^/]+$", // "required": true, @@ -7249,8 +7260,9 @@ type NamespacesJobsRunCall struct { // Run: Trigger creation of a new execution of this job. // -// - name: The name of the job to run. Replace {namespace_id} with the -// project ID or number. +// - name: The name of the job to run. Replace {namespace} with the +// project ID or number. It takes the form namespaces/{namespace}. For +// example: namespaces/PROJECT_ID. func (r *NamespacesJobsService) Run(name string, runjobrequest *RunJobRequest) *NamespacesJobsRunCall { c := &NamespacesJobsRunCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -7358,7 +7370,7 @@ func (c *NamespacesJobsRunCall) Do(opts ...googleapi.CallOption) (*Execution, er // ], // "parameters": { // "name": { - // "description": "Required. The name of the job to run. Replace {namespace_id} with the project ID or number.", + // "description": "Required. The name of the job to run. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+/jobs/[^/]+$", // "required": true, @@ -7392,7 +7404,9 @@ type NamespacesRevisionsDeleteCall struct { // Delete: Delete a revision. // // - name: The name of the revision to delete. For Cloud Run (fully -// managed), replace {namespace_id} with the project ID or number. +// managed), replace {namespace} with the project ID or number. It +// takes the form namespaces/{namespace}. For example: +// namespaces/PROJECT_ID. func (r *NamespacesRevisionsService) Delete(name string) *NamespacesRevisionsDeleteCall { c := &NamespacesRevisionsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -7541,7 +7555,7 @@ func (c *NamespacesRevisionsDeleteCall) Do(opts ...googleapi.CallOption) (*Statu // "type": "string" // }, // "name": { - // "description": "The name of the revision to delete. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The name of the revision to delete. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+/revisions/[^/]+$", // "required": true, @@ -7578,7 +7592,9 @@ type NamespacesRevisionsGetCall struct { // Get: Get information about a revision. // // - name: The name of the revision to retrieve. For Cloud Run (fully -// managed), replace {namespace_id} with the project ID or number. +// managed), replace {namespace} with the project ID or number. It +// takes the form namespaces/{namespace}. For example: +// namespaces/PROJECT_ID. func (r *NamespacesRevisionsService) Get(name string) *NamespacesRevisionsGetCall { c := &NamespacesRevisionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -7693,7 +7709,7 @@ func (c *NamespacesRevisionsGetCall) Do(opts ...googleapi.CallOption) (*Revision // ], // "parameters": { // "name": { - // "description": "The name of the revision to retrieve. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The name of the revision to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+/revisions/[^/]+$", // "required": true, @@ -7725,8 +7741,9 @@ type NamespacesRevisionsListCall struct { // List: List revisions. // // - parent: The namespace from which the revisions should be listed. -// For Cloud Run (fully managed), replace {namespace_id} with the -// project ID or number. +// For Cloud Run (fully managed), replace {namespace} with the project +// ID or number. It takes the form namespaces/{namespace}. For +// example: namespaces/PROJECT_ID. func (r *NamespacesRevisionsService) List(parent string) *NamespacesRevisionsListCall { c := &NamespacesRevisionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -7921,7 +7938,7 @@ func (c *NamespacesRevisionsListCall) Do(opts ...googleapi.CallOption) (*ListRev // "type": "integer" // }, // "parent": { - // "description": "The namespace from which the revisions should be listed. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The namespace from which the revisions should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+$", // "required": true, @@ -7963,7 +7980,9 @@ type NamespacesRoutesGetCall struct { // Get: Get information about a route. // // - name: The name of the route to retrieve. For Cloud Run (fully -// managed), replace {namespace_id} with the project ID or number. +// managed), replace {namespace} with the project ID or number. It +// takes the form namespaces/{namespace}. For example: +// namespaces/PROJECT_ID. func (r *NamespacesRoutesService) Get(name string) *NamespacesRoutesGetCall { c := &NamespacesRoutesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -8078,7 +8097,7 @@ func (c *NamespacesRoutesGetCall) Do(opts ...googleapi.CallOption) (*Route, erro // ], // "parameters": { // "name": { - // "description": "The name of the route to retrieve. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The name of the route to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+/routes/[^/]+$", // "required": true, @@ -8110,8 +8129,9 @@ type NamespacesRoutesListCall struct { // List: List routes. // // - parent: The namespace from which the routes should be listed. For -// Cloud Run (fully managed), replace {namespace_id} with the project -// ID or number. +// Cloud Run (fully managed), replace {namespace} with the project ID +// or number. It takes the form namespaces/{namespace}. For example: +// namespaces/PROJECT_ID. func (r *NamespacesRoutesService) List(parent string) *NamespacesRoutesListCall { c := &NamespacesRoutesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8306,7 +8326,7 @@ func (c *NamespacesRoutesListCall) Do(opts ...googleapi.CallOption) (*ListRoutes // "type": "integer" // }, // "parent": { - // "description": "The namespace from which the routes should be listed. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The namespace from which the routes should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+$", // "required": true, @@ -8347,9 +8367,10 @@ type NamespacesServicesCreateCall struct { // Create: Create a service. // -// - parent: The namespace in which the service should be created. For -// Cloud Run (fully managed), replace {namespace_id} with the project -// ID or number. +// - parent: LINT.IfChange() The namespace in which the service should +// be created. For Cloud Run (fully managed), replace {namespace} with +// the project ID or number. It takes the form namespaces/{namespace}. +// For example: namespaces/PROJECT_ID. func (r *NamespacesServicesService) Create(parent string, service *Service) *NamespacesServicesCreateCall { c := &NamespacesServicesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8360,6 +8381,8 @@ func (r *NamespacesServicesService) Create(parent string, service *Service) *Nam // DryRun sets the optional parameter "dryRun": Indicates that the // server should validate the request and populate default values // without persisting the request. Supported values: `all` +// LINT.ThenChange(//depot/google3/google/cloud/serverless/v1/internal_se +// rvice.proto:create_internal_service_request) func (c *NamespacesServicesCreateCall) DryRun(dryRun string) *NamespacesServicesCreateCall { c.urlParams_.Set("dryRun", dryRun) return c @@ -8465,12 +8488,12 @@ func (c *NamespacesServicesCreateCall) Do(opts ...googleapi.CallOption) (*Servic // ], // "parameters": { // "dryRun": { - // "description": "Indicates that the server should validate the request and populate default values without persisting the request. Supported values: `all`", + // "description": "Indicates that the server should validate the request and populate default values without persisting the request. Supported values: `all` LINT.ThenChange(//depot/google3/google/cloud/serverless/v1/internal_service.proto:create_internal_service_request)", // "location": "query", // "type": "string" // }, // "parent": { - // "description": "The namespace in which the service should be created. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "LINT.IfChange() The namespace in which the service should be created. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+$", // "required": true, @@ -8506,7 +8529,9 @@ type NamespacesServicesDeleteCall struct { // Configurations and Revisions. // // - name: The name of the service to delete. For Cloud Run (fully -// managed), replace {namespace_id} with the project ID or number. +// managed), replace {namespace} with the project ID or number. It +// takes the form namespaces/{namespace}. For example: +// namespaces/PROJECT_ID. func (r *NamespacesServicesService) Delete(name string) *NamespacesServicesDeleteCall { c := &NamespacesServicesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -8655,7 +8680,7 @@ func (c *NamespacesServicesDeleteCall) Do(opts ...googleapi.CallOption) (*Status // "type": "string" // }, // "name": { - // "description": "The name of the service to delete. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The name of the service to delete. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+/services/[^/]+$", // "required": true, @@ -8692,7 +8717,9 @@ type NamespacesServicesGetCall struct { // Get: Get information about a service. // // - name: The name of the service to retrieve. For Cloud Run (fully -// managed), replace {namespace_id} with the project ID or number. +// managed), replace {namespace} with the project ID or number. It +// takes the form namespaces/{namespace}. For example: +// namespaces/PROJECT_ID. func (r *NamespacesServicesService) Get(name string) *NamespacesServicesGetCall { c := &NamespacesServicesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -8807,7 +8834,7 @@ func (c *NamespacesServicesGetCall) Do(opts ...googleapi.CallOption) (*Service, // ], // "parameters": { // "name": { - // "description": "The name of the service to retrieve. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The name of the service to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+/services/[^/]+$", // "required": true, @@ -8839,8 +8866,9 @@ type NamespacesServicesListCall struct { // List: List services. // // - parent: The namespace from which the services should be listed. For -// Cloud Run (fully managed), replace {namespace_id} with the project -// ID or number. +// Cloud Run (fully managed), replace {namespace} with the project ID +// or number. It takes the form namespaces/{namespace}. For example: +// namespaces/PROJECT_ID. func (r *NamespacesServicesService) List(parent string) *NamespacesServicesListCall { c := &NamespacesServicesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -9035,7 +9063,7 @@ func (c *NamespacesServicesListCall) Do(opts ...googleapi.CallOption) (*ListServ // "type": "integer" // }, // "parent": { - // "description": "The namespace from which the services should be listed. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The namespace from which the services should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+$", // "required": true, @@ -9080,8 +9108,10 @@ type NamespacesServicesReplaceServiceCall struct { // provide metadata.resourceVersion to enforce update from last read for // optimistic concurrency control. // -// - name: The name of the service being replaced. For Cloud Run (fully -// managed), replace {namespace_id} with the project ID or number. +// - name: LINT.IfChange() The name of the service being replaced. For +// Cloud Run (fully managed), replace {namespace} with the project ID +// or number. It takes the form namespaces/{namespace}. For example: +// namespaces/PROJECT_ID. func (r *NamespacesServicesService) ReplaceService(name string, service *Service) *NamespacesServicesReplaceServiceCall { c := &NamespacesServicesReplaceServiceCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -9092,6 +9122,8 @@ func (r *NamespacesServicesService) ReplaceService(name string, service *Service // DryRun sets the optional parameter "dryRun": Indicates that the // server should validate the request and populate default values // without persisting the request. Supported values: `all` +// LINT.ThenChange(//depot/google3/google/cloud/serverless/v1/internal_se +// rvice.proto:replace_internal_service_request) func (c *NamespacesServicesReplaceServiceCall) DryRun(dryRun string) *NamespacesServicesReplaceServiceCall { c.urlParams_.Set("dryRun", dryRun) return c @@ -9197,12 +9229,12 @@ func (c *NamespacesServicesReplaceServiceCall) Do(opts ...googleapi.CallOption) // ], // "parameters": { // "dryRun": { - // "description": "Indicates that the server should validate the request and populate default values without persisting the request. Supported values: `all`", + // "description": "Indicates that the server should validate the request and populate default values without persisting the request. Supported values: `all` LINT.ThenChange(//depot/google3/google/cloud/serverless/v1/internal_service.proto:replace_internal_service_request)", // "location": "query", // "type": "string" // }, // "name": { - // "description": "The name of the service being replaced. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "LINT.IfChange() The name of the service being replaced. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+/services/[^/]+$", // "required": true, @@ -9236,8 +9268,9 @@ type NamespacesTasksGetCall struct { // Get: Get information about a task. // -// - name: The name of the task to retrieve. Replace {namespace_id} with -// the project ID or number. +// - name: The name of the task to retrieve. Replace {namespace} with +// the project ID or number. It takes the form namespaces/{namespace}. +// For example: namespaces/PROJECT_ID. func (r *NamespacesTasksService) Get(name string) *NamespacesTasksGetCall { c := &NamespacesTasksGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -9352,7 +9385,7 @@ func (c *NamespacesTasksGetCall) Do(opts ...googleapi.CallOption) (*Task, error) // ], // "parameters": { // "name": { - // "description": "Required. The name of the task to retrieve. Replace {namespace_id} with the project ID or number.", + // "description": "Required. The name of the task to retrieve. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+/tasks/[^/]+$", // "required": true, @@ -9384,7 +9417,8 @@ type NamespacesTasksListCall struct { // List: List tasks. // // - parent: The namespace from which the tasks should be listed. -// Replace {namespace_id} with the project ID or number. +// Replace {namespace} with the project ID or number. It takes the +// form namespaces/{namespace}. For example: namespaces/PROJECT_ID. func (r *NamespacesTasksService) List(parent string) *NamespacesTasksListCall { c := &NamespacesTasksListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -9579,7 +9613,7 @@ func (c *NamespacesTasksListCall) Do(opts ...googleapi.CallOption) (*ListTasksRe // "type": "integer" // }, // "parent": { - // "description": "Required. The namespace from which the tasks should be listed. Replace {namespace_id} with the project ID or number.", + // "description": "Required. The namespace from which the tasks should be listed. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^namespaces/[^/]+$", // "required": true, @@ -9824,8 +9858,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 @@ -9954,7 +9988,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" // }, @@ -10602,8 +10636,9 @@ type ProjectsLocationsDomainmappingsCreateCall struct { // Create: Create a new domain mapping. // // - parent: The namespace in which the domain mapping should be -// created. For Cloud Run (fully managed), replace {namespace_id} with -// the project ID or number. +// created. For Cloud Run (fully managed), replace {namespace} with +// the project ID or number. It takes the form namespaces/{namespace}. +// For example: namespaces/PROJECT_ID. func (r *ProjectsLocationsDomainmappingsService) Create(parent string, domainmapping *DomainMapping) *ProjectsLocationsDomainmappingsCreateCall { c := &ProjectsLocationsDomainmappingsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -10724,7 +10759,7 @@ func (c *ProjectsLocationsDomainmappingsCreateCall) Do(opts ...googleapi.CallOpt // "type": "string" // }, // "parent": { - // "description": "The namespace in which the domain mapping should be created. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The namespace in which the domain mapping should be created. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, @@ -10758,8 +10793,9 @@ type ProjectsLocationsDomainmappingsDeleteCall struct { // Delete: Delete a domain mapping. // // - name: The name of the domain mapping to delete. For Cloud Run -// (fully managed), replace {namespace_id} with the project ID or -// number. +// (fully managed), replace {namespace} with the project ID or number. +// It takes the form namespaces/{namespace}. For example: +// namespaces/PROJECT_ID. func (r *ProjectsLocationsDomainmappingsService) Delete(name string) *ProjectsLocationsDomainmappingsDeleteCall { c := &ProjectsLocationsDomainmappingsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -10908,7 +10944,7 @@ func (c *ProjectsLocationsDomainmappingsDeleteCall) Do(opts ...googleapi.CallOpt // "type": "string" // }, // "name": { - // "description": "The name of the domain mapping to delete. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The name of the domain mapping to delete. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/domainmappings/[^/]+$", // "required": true, @@ -10945,8 +10981,9 @@ type ProjectsLocationsDomainmappingsGetCall struct { // Get: Get information about a domain mapping. // // - name: The name of the domain mapping to retrieve. For Cloud Run -// (fully managed), replace {namespace_id} with the project ID or -// number. +// (fully managed), replace {namespace} with the project ID or number. +// It takes the form namespaces/{namespace}. For example: +// namespaces/PROJECT_ID. func (r *ProjectsLocationsDomainmappingsService) Get(name string) *ProjectsLocationsDomainmappingsGetCall { c := &ProjectsLocationsDomainmappingsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -11061,7 +11098,7 @@ func (c *ProjectsLocationsDomainmappingsGetCall) Do(opts ...googleapi.CallOption // ], // "parameters": { // "name": { - // "description": "The name of the domain mapping to retrieve. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The name of the domain mapping to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/domainmappings/[^/]+$", // "required": true, @@ -11093,8 +11130,9 @@ type ProjectsLocationsDomainmappingsListCall struct { // List: List domain mappings. // // - parent: The namespace from which the domain mappings should be -// listed. For Cloud Run (fully managed), replace {namespace_id} with -// the project ID or number. +// listed. For Cloud Run (fully managed), replace {namespace} with the +// project ID or number. It takes the form namespaces/{namespace}. For +// example: namespaces/PROJECT_ID. func (r *ProjectsLocationsDomainmappingsService) List(parent string) *ProjectsLocationsDomainmappingsListCall { c := &ProjectsLocationsDomainmappingsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -11289,7 +11327,7 @@ func (c *ProjectsLocationsDomainmappingsListCall) Do(opts ...googleapi.CallOptio // "type": "integer" // }, // "parent": { - // "description": "The namespace from which the domain mappings should be listed. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The namespace from which the domain mappings should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, @@ -11795,7 +11833,9 @@ type ProjectsLocationsRevisionsDeleteCall struct { // Delete: Delete a revision. // // - name: The name of the revision to delete. For Cloud Run (fully -// managed), replace {namespace_id} with the project ID or number. +// managed), replace {namespace} with the project ID or number. It +// takes the form namespaces/{namespace}. For example: +// namespaces/PROJECT_ID. func (r *ProjectsLocationsRevisionsService) Delete(name string) *ProjectsLocationsRevisionsDeleteCall { c := &ProjectsLocationsRevisionsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -11944,7 +11984,7 @@ func (c *ProjectsLocationsRevisionsDeleteCall) Do(opts ...googleapi.CallOption) // "type": "string" // }, // "name": { - // "description": "The name of the revision to delete. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The name of the revision to delete. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/revisions/[^/]+$", // "required": true, @@ -11981,7 +12021,9 @@ type ProjectsLocationsRevisionsGetCall struct { // Get: Get information about a revision. // // - name: The name of the revision to retrieve. For Cloud Run (fully -// managed), replace {namespace_id} with the project ID or number. +// managed), replace {namespace} with the project ID or number. It +// takes the form namespaces/{namespace}. For example: +// namespaces/PROJECT_ID. func (r *ProjectsLocationsRevisionsService) Get(name string) *ProjectsLocationsRevisionsGetCall { c := &ProjectsLocationsRevisionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -12096,7 +12138,7 @@ func (c *ProjectsLocationsRevisionsGetCall) Do(opts ...googleapi.CallOption) (*R // ], // "parameters": { // "name": { - // "description": "The name of the revision to retrieve. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The name of the revision to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/revisions/[^/]+$", // "required": true, @@ -12128,8 +12170,9 @@ type ProjectsLocationsRevisionsListCall struct { // List: List revisions. // // - parent: The namespace from which the revisions should be listed. -// For Cloud Run (fully managed), replace {namespace_id} with the -// project ID or number. +// For Cloud Run (fully managed), replace {namespace} with the project +// ID or number. It takes the form namespaces/{namespace}. For +// example: namespaces/PROJECT_ID. func (r *ProjectsLocationsRevisionsService) List(parent string) *ProjectsLocationsRevisionsListCall { c := &ProjectsLocationsRevisionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -12324,7 +12367,7 @@ func (c *ProjectsLocationsRevisionsListCall) Do(opts ...googleapi.CallOption) (* // "type": "integer" // }, // "parent": { - // "description": "The namespace from which the revisions should be listed. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The namespace from which the revisions should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, @@ -12366,7 +12409,9 @@ type ProjectsLocationsRoutesGetCall struct { // Get: Get information about a route. // // - name: The name of the route to retrieve. For Cloud Run (fully -// managed), replace {namespace_id} with the project ID or number. +// managed), replace {namespace} with the project ID or number. It +// takes the form namespaces/{namespace}. For example: +// namespaces/PROJECT_ID. func (r *ProjectsLocationsRoutesService) Get(name string) *ProjectsLocationsRoutesGetCall { c := &ProjectsLocationsRoutesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -12481,7 +12526,7 @@ func (c *ProjectsLocationsRoutesGetCall) Do(opts ...googleapi.CallOption) (*Rout // ], // "parameters": { // "name": { - // "description": "The name of the route to retrieve. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The name of the route to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/routes/[^/]+$", // "required": true, @@ -12513,8 +12558,9 @@ type ProjectsLocationsRoutesListCall struct { // List: List routes. // // - parent: The namespace from which the routes should be listed. For -// Cloud Run (fully managed), replace {namespace_id} with the project -// ID or number. +// Cloud Run (fully managed), replace {namespace} with the project ID +// or number. It takes the form namespaces/{namespace}. For example: +// namespaces/PROJECT_ID. func (r *ProjectsLocationsRoutesService) List(parent string) *ProjectsLocationsRoutesListCall { c := &ProjectsLocationsRoutesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -12709,7 +12755,7 @@ func (c *ProjectsLocationsRoutesListCall) Do(opts ...googleapi.CallOption) (*Lis // "type": "integer" // }, // "parent": { - // "description": "The namespace from which the routes should be listed. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The namespace from which the routes should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, @@ -12750,9 +12796,10 @@ type ProjectsLocationsServicesCreateCall struct { // Create: Create a service. // -// - parent: The namespace in which the service should be created. For -// Cloud Run (fully managed), replace {namespace_id} with the project -// ID or number. +// - parent: LINT.IfChange() The namespace in which the service should +// be created. For Cloud Run (fully managed), replace {namespace} with +// the project ID or number. It takes the form namespaces/{namespace}. +// For example: namespaces/PROJECT_ID. func (r *ProjectsLocationsServicesService) Create(parent string, service *Service) *ProjectsLocationsServicesCreateCall { c := &ProjectsLocationsServicesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -12763,6 +12810,8 @@ func (r *ProjectsLocationsServicesService) Create(parent string, service *Servic // DryRun sets the optional parameter "dryRun": Indicates that the // server should validate the request and populate default values // without persisting the request. Supported values: `all` +// LINT.ThenChange(//depot/google3/google/cloud/serverless/v1/internal_se +// rvice.proto:create_internal_service_request) func (c *ProjectsLocationsServicesCreateCall) DryRun(dryRun string) *ProjectsLocationsServicesCreateCall { c.urlParams_.Set("dryRun", dryRun) return c @@ -12868,12 +12917,12 @@ func (c *ProjectsLocationsServicesCreateCall) Do(opts ...googleapi.CallOption) ( // ], // "parameters": { // "dryRun": { - // "description": "Indicates that the server should validate the request and populate default values without persisting the request. Supported values: `all`", + // "description": "Indicates that the server should validate the request and populate default values without persisting the request. Supported values: `all` LINT.ThenChange(//depot/google3/google/cloud/serverless/v1/internal_service.proto:create_internal_service_request)", // "location": "query", // "type": "string" // }, // "parent": { - // "description": "The namespace in which the service should be created. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "LINT.IfChange() The namespace in which the service should be created. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, @@ -12909,7 +12958,9 @@ type ProjectsLocationsServicesDeleteCall struct { // Configurations and Revisions. // // - name: The name of the service to delete. For Cloud Run (fully -// managed), replace {namespace_id} with the project ID or number. +// managed), replace {namespace} with the project ID or number. It +// takes the form namespaces/{namespace}. For example: +// namespaces/PROJECT_ID. func (r *ProjectsLocationsServicesService) Delete(name string) *ProjectsLocationsServicesDeleteCall { c := &ProjectsLocationsServicesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -13058,7 +13109,7 @@ func (c *ProjectsLocationsServicesDeleteCall) Do(opts ...googleapi.CallOption) ( // "type": "string" // }, // "name": { - // "description": "The name of the service to delete. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The name of the service to delete. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", // "required": true, @@ -13095,7 +13146,9 @@ type ProjectsLocationsServicesGetCall struct { // Get: Get information about a service. // // - name: The name of the service to retrieve. For Cloud Run (fully -// managed), replace {namespace_id} with the project ID or number. +// managed), replace {namespace} with the project ID or number. It +// takes the form namespaces/{namespace}. For example: +// namespaces/PROJECT_ID. func (r *ProjectsLocationsServicesService) Get(name string) *ProjectsLocationsServicesGetCall { c := &ProjectsLocationsServicesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -13210,7 +13263,7 @@ func (c *ProjectsLocationsServicesGetCall) Do(opts ...googleapi.CallOption) (*Se // ], // "parameters": { // "name": { - // "description": "The name of the service to retrieve. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The name of the service to retrieve. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", // "required": true, @@ -13416,8 +13469,9 @@ type ProjectsLocationsServicesListCall struct { // List: List services. // // - parent: The namespace from which the services should be listed. For -// Cloud Run (fully managed), replace {namespace_id} with the project -// ID or number. +// Cloud Run (fully managed), replace {namespace} with the project ID +// or number. It takes the form namespaces/{namespace}. For example: +// namespaces/PROJECT_ID. func (r *ProjectsLocationsServicesService) List(parent string) *ProjectsLocationsServicesListCall { c := &ProjectsLocationsServicesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -13612,7 +13666,7 @@ func (c *ProjectsLocationsServicesListCall) Do(opts ...googleapi.CallOption) (*L // "type": "integer" // }, // "parent": { - // "description": "The namespace from which the services should be listed. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "The namespace from which the services should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+$", // "required": true, @@ -13657,8 +13711,10 @@ type ProjectsLocationsServicesReplaceServiceCall struct { // provide metadata.resourceVersion to enforce update from last read for // optimistic concurrency control. // -// - name: The name of the service being replaced. For Cloud Run (fully -// managed), replace {namespace_id} with the project ID or number. +// - name: LINT.IfChange() The name of the service being replaced. For +// Cloud Run (fully managed), replace {namespace} with the project ID +// or number. It takes the form namespaces/{namespace}. For example: +// namespaces/PROJECT_ID. func (r *ProjectsLocationsServicesService) ReplaceService(name string, service *Service) *ProjectsLocationsServicesReplaceServiceCall { c := &ProjectsLocationsServicesReplaceServiceCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -13669,6 +13725,8 @@ func (r *ProjectsLocationsServicesService) ReplaceService(name string, service * // DryRun sets the optional parameter "dryRun": Indicates that the // server should validate the request and populate default values // without persisting the request. Supported values: `all` +// LINT.ThenChange(//depot/google3/google/cloud/serverless/v1/internal_se +// rvice.proto:replace_internal_service_request) func (c *ProjectsLocationsServicesReplaceServiceCall) DryRun(dryRun string) *ProjectsLocationsServicesReplaceServiceCall { c.urlParams_.Set("dryRun", dryRun) return c @@ -13774,12 +13832,12 @@ func (c *ProjectsLocationsServicesReplaceServiceCall) Do(opts ...googleapi.CallO // ], // "parameters": { // "dryRun": { - // "description": "Indicates that the server should validate the request and populate default values without persisting the request. Supported values: `all`", + // "description": "Indicates that the server should validate the request and populate default values without persisting the request. Supported values: `all` LINT.ThenChange(//depot/google3/google/cloud/serverless/v1/internal_service.proto:replace_internal_service_request)", // "location": "query", // "type": "string" // }, // "name": { - // "description": "The name of the service being replaced. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.", + // "description": "LINT.IfChange() The name of the service being replaced. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$", // "required": true, diff --git a/run/v2/run-api.json b/run/v2/run-api.json index dd2e78077bf..4fc3e232ba8 100644 --- a/run/v2/run-api.json +++ b/run/v2/run-api.json @@ -590,7 +590,7 @@ } } }, - "revision": "20220318", + "revision": "20220401", "rootUrl": "https://run.googleapis.com/", "schemas": { "GoogleCloudRunV2BinaryAuthorization": { @@ -601,6 +601,10 @@ "description": "If present, indicates to use Breakglass using this justification. If use_default is False, then it must be empty. For more information on breakglass, see https://cloud.google.com/binary-authorization/docs/using-breakglass", "type": "string" }, + "policy": { + "description": "The path to a binary authorization policy. Format: projects/{project}/platforms/cloudRun/{policy-name}", + "type": "string" + }, "useDefault": { "description": "If True, indicates to use the default project's binary authorization policy. If False, binary authorization will be disabled.", "type": "boolean" @@ -1022,12 +1026,12 @@ "description": "The execution environment being used to host this Revision.", "enum": [ "EXECUTION_ENVIRONMENT_UNSPECIFIED", - "EXECUTION_ENVIRONMENT_DEFAULT", + "EXECUTION_ENVIRONMENT_GEN1", "EXECUTION_ENVIRONMENT_GEN2" ], "enumDescriptions": [ "Unspecified", - "Uses the Google-default environment.", + "Uses the First Generation environment.", "Uses Second Generation environment." ], "type": "string" @@ -1191,12 +1195,12 @@ "description": "The sandbox environment to host this Revision.", "enum": [ "EXECUTION_ENVIRONMENT_UNSPECIFIED", - "EXECUTION_ENVIRONMENT_DEFAULT", + "EXECUTION_ENVIRONMENT_GEN1", "EXECUTION_ENVIRONMENT_GEN2" ], "enumDescriptions": [ "Unspecified", - "Uses the Google-default environment.", + "Uses the First Generation environment.", "Uses Second Generation environment." ], "type": "string" diff --git a/run/v2/run-gen.go b/run/v2/run-gen.go index 97295caa4f9..3c7b6616526 100644 --- a/run/v2/run-gen.go +++ b/run/v2/run-gen.go @@ -203,6 +203,10 @@ type GoogleCloudRunV2BinaryAuthorization struct { // https://cloud.google.com/binary-authorization/docs/using-breakglass BreakglassJustification string `json:"breakglassJustification,omitempty"` + // Policy: The path to a binary authorization policy. Format: + // projects/{project}/platforms/cloudRun/{policy-name} + Policy string `json:"policy,omitempty"` + // UseDefault: If True, indicates to use the default project's binary // authorization policy. If False, binary authorization will be // disabled. @@ -767,7 +771,7 @@ type GoogleCloudRunV2Revision struct { // // Possible values: // "EXECUTION_ENVIRONMENT_UNSPECIFIED" - Unspecified - // "EXECUTION_ENVIRONMENT_DEFAULT" - Uses the Google-default + // "EXECUTION_ENVIRONMENT_GEN1" - Uses the First Generation // environment. // "EXECUTION_ENVIRONMENT_GEN2" - Uses Second Generation environment. ExecutionEnvironment string `json:"executionEnvironment,omitempty"` @@ -971,7 +975,7 @@ type GoogleCloudRunV2RevisionTemplate struct { // // Possible values: // "EXECUTION_ENVIRONMENT_UNSPECIFIED" - Unspecified - // "EXECUTION_ENVIRONMENT_DEFAULT" - Uses the Google-default + // "EXECUTION_ENVIRONMENT_GEN1" - Uses the First Generation // environment. // "EXECUTION_ENVIRONMENT_GEN2" - Uses Second Generation environment. ExecutionEnvironment string `json:"executionEnvironment,omitempty"` diff --git a/securitycenter/v1/securitycenter-api.json b/securitycenter/v1/securitycenter-api.json index aae779f745c..428269207bf 100644 --- a/securitycenter/v1/securitycenter-api.json +++ b/securitycenter/v1/securitycenter-api.json @@ -3058,7 +3058,7 @@ } } }, - "revision": "20220324", + "revision": "20220401", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -3505,6 +3505,13 @@ ], "type": "string" }, + "iamBindings": { + "description": "Represents IAM bindings associated with the Finding.", + "items": { + "$ref": "IamBinding" + }, + "type": "array" + }, "indicator": { "$ref": "Indicator", "description": "Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise" @@ -3543,6 +3550,10 @@ "description": "The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: \"organizations/{organization_id}/sources/{source_id}/findings/{finding_id}\"", "type": "string" }, + "nextSteps": { + "description": "Next steps associate to the finding.", + "type": "string" + }, "parent": { "description": "The relative resource name of the source the finding belongs to. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: \"organizations/{organization_id}/sources/{source_id}\"", "type": "string" @@ -4238,6 +4249,35 @@ }, "type": "object" }, + "IamBinding": { + "description": "Represents a particular IAM binding, which captures a member's role addition, removal, or state.", + "id": "IamBinding", + "properties": { + "action": { + "description": "The action that was performed on a Binding.", + "enum": [ + "ACTION_UNSPECIFIED", + "ADD", + "REMOVE" + ], + "enumDescriptions": [ + "Unspecified.", + "Addition of a Binding.", + "Removal of a Binding." + ], + "type": "string" + }, + "member": { + "description": "A single identity requesting access for a Cloud Platform resource, e.g. \"foo@google.com\".", + "type": "string" + }, + "role": { + "description": "Role that is assigned to \"members\". For example, \"roles/viewer\", \"roles/editor\", or \"roles/owner\".", + "type": "string" + } + }, + "type": "object" + }, "IamPolicy": { "description": "Cloud IAM Policy information associated with the Google Cloud resource described by the Security Command Center asset. This information is managed and defined by the Google Cloud resource and cannot be modified by the user.", "id": "IamPolicy", diff --git a/securitycenter/v1/securitycenter-gen.go b/securitycenter/v1/securitycenter-gen.go index 6cf7868a6f8..c22b4e27b82 100644 --- a/securitycenter/v1/securitycenter-gen.go +++ b/securitycenter/v1/securitycenter-gen.go @@ -1157,6 +1157,9 @@ type Finding struct { // functionality. FindingClass string `json:"findingClass,omitempty"` + // IamBindings: Represents IAM bindings associated with the Finding. + IamBindings []*IamBinding `json:"iamBindings,omitempty"` + // Indicator: Represents what's commonly known as an Indicator of // compromise (IoC) in computer forensics. This is an artifact observed // on a network or in an operating system that, with high confidence, @@ -1196,6 +1199,9 @@ type Finding struct { // _id}" Name string `json:"name,omitempty"` + // NextSteps: Next steps associate to the finding. + NextSteps string `json:"nextSteps,omitempty"` + // Parent: The relative resource name of the source the finding belongs // to. See: // https://cloud.google.com/apis/design/resource_names#relative_resource_name @@ -2501,6 +2507,48 @@ func (s *GroupResult) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// IamBinding: Represents a particular IAM binding, which captures a +// member's role addition, removal, or state. +type IamBinding struct { + // Action: The action that was performed on a Binding. + // + // Possible values: + // "ACTION_UNSPECIFIED" - Unspecified. + // "ADD" - Addition of a Binding. + // "REMOVE" - Removal of a Binding. + Action string `json:"action,omitempty"` + + // Member: A single identity requesting access for a Cloud Platform + // resource, e.g. "foo@google.com". + Member string `json:"member,omitempty"` + + // Role: Role that is assigned to "members". For example, + // "roles/viewer", "roles/editor", or "roles/owner". + 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 *IamBinding) MarshalJSON() ([]byte, error) { + type NoMethod IamBinding + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // IamPolicy: Cloud IAM Policy information associated with the Google // Cloud resource described by the Security Command Center asset. This // information is managed and defined by the Google Cloud resource and diff --git a/securitycenter/v1beta1/securitycenter-api.json b/securitycenter/v1beta1/securitycenter-api.json index cebbe082484..299d4a77078 100644 --- a/securitycenter/v1beta1/securitycenter-api.json +++ b/securitycenter/v1beta1/securitycenter-api.json @@ -896,7 +896,7 @@ } } }, - "revision": "20220324", + "revision": "20220401", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -1319,6 +1319,13 @@ ], "type": "string" }, + "iamBindings": { + "description": "Represents IAM bindings associated with the Finding.", + "items": { + "$ref": "IamBinding" + }, + "type": "array" + }, "indicator": { "$ref": "Indicator", "description": "Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise" @@ -1357,6 +1364,10 @@ "description": "The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: \"organizations/{organization_id}/sources/{source_id}/findings/{finding_id}\"", "type": "string" }, + "nextSteps": { + "description": "Next steps associate to the finding.", + "type": "string" + }, "parent": { "description": "The relative resource name of the source the finding belongs to. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: \"organizations/{organization_id}/sources/{source_id}\"", "type": "string" @@ -2118,6 +2129,35 @@ }, "type": "object" }, + "IamBinding": { + "description": "Represents a particular IAM binding, which captures a member's role addition, removal, or state.", + "id": "IamBinding", + "properties": { + "action": { + "description": "The action that was performed on a Binding.", + "enum": [ + "ACTION_UNSPECIFIED", + "ADD", + "REMOVE" + ], + "enumDescriptions": [ + "Unspecified.", + "Addition of a Binding.", + "Removal of a Binding." + ], + "type": "string" + }, + "member": { + "description": "A single identity requesting access for a Cloud Platform resource, e.g. \"foo@google.com\".", + "type": "string" + }, + "role": { + "description": "Role that is assigned to \"members\". For example, \"roles/viewer\", \"roles/editor\", or \"roles/owner\".", + "type": "string" + } + }, + "type": "object" + }, "Indicator": { "description": "Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise", "id": "Indicator", diff --git a/securitycenter/v1beta1/securitycenter-gen.go b/securitycenter/v1beta1/securitycenter-gen.go index 5a02538858d..66eeb4e458e 100644 --- a/securitycenter/v1beta1/securitycenter-gen.go +++ b/securitycenter/v1beta1/securitycenter-gen.go @@ -848,6 +848,9 @@ type Finding struct { // functionality. FindingClass string `json:"findingClass,omitempty"` + // IamBindings: Represents IAM bindings associated with the Finding. + IamBindings []*IamBinding `json:"iamBindings,omitempty"` + // Indicator: Represents what's commonly known as an Indicator of // compromise (IoC) in computer forensics. This is an artifact observed // on a network or in an operating system that, with high confidence, @@ -887,6 +890,9 @@ type Finding struct { // _id}" Name string `json:"name,omitempty"` + // NextSteps: Next steps associate to the finding. + NextSteps string `json:"nextSteps,omitempty"` + // Parent: The relative resource name of the source the finding belongs // to. See: // https://cloud.google.com/apis/design/resource_names#relative_resource_name @@ -2249,6 +2255,48 @@ func (s *GroupResult) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// IamBinding: Represents a particular IAM binding, which captures a +// member's role addition, removal, or state. +type IamBinding struct { + // Action: The action that was performed on a Binding. + // + // Possible values: + // "ACTION_UNSPECIFIED" - Unspecified. + // "ADD" - Addition of a Binding. + // "REMOVE" - Removal of a Binding. + Action string `json:"action,omitempty"` + + // Member: A single identity requesting access for a Cloud Platform + // resource, e.g. "foo@google.com". + Member string `json:"member,omitempty"` + + // Role: Role that is assigned to "members". For example, + // "roles/viewer", "roles/editor", or "roles/owner". + 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 *IamBinding) MarshalJSON() ([]byte, error) { + type NoMethod IamBinding + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Indicator: Represents what's commonly known as an Indicator of // compromise (IoC) in computer forensics. This is an artifact observed // on a network or in an operating system that, with high confidence, diff --git a/securitycenter/v1beta2/securitycenter-api.json b/securitycenter/v1beta2/securitycenter-api.json index dabfd114ec2..a14ecdaa657 100644 --- a/securitycenter/v1beta2/securitycenter-api.json +++ b/securitycenter/v1beta2/securitycenter-api.json @@ -157,6 +157,31 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "getOnboardingState": { + "description": "Retrieve the OnboardingState of a resource.", + "flatPath": "v1beta2/folders/{foldersId}/onboardingState", + "httpMethod": "GET", + "id": "securitycenter.folders.getOnboardingState", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the OnboardingState to retrieve. Formats: * organizations/{organization}/onboardingState * folders/{folder}/onboardingState * projects/{project}/onboardingState", + "location": "path", + "pattern": "^folders/[^/]+/onboardingState$", + "required": true, + "type": "string" + } + }, + "path": "v1beta2/{+name}", + "response": { + "$ref": "OnboardingState" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "getSecurityHealthAnalyticsSettings": { "description": "Get the SecurityHealthAnalyticsSettings resource.", "flatPath": "v1beta2/folders/{foldersId}/securityHealthAnalyticsSettings", @@ -603,6 +628,31 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "getOnboardingState": { + "description": "Retrieve the OnboardingState of a resource.", + "flatPath": "v1beta2/organizations/{organizationsId}/onboardingState", + "httpMethod": "GET", + "id": "securitycenter.organizations.getOnboardingState", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the OnboardingState to retrieve. Formats: * organizations/{organization}/onboardingState * folders/{folder}/onboardingState * projects/{project}/onboardingState", + "location": "path", + "pattern": "^organizations/[^/]+/onboardingState$", + "required": true, + "type": "string" + } + }, + "path": "v1beta2/{+name}", + "response": { + "$ref": "OnboardingState" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "getSecurityCenterSettings": { "description": "Get the SecurityCenterSettings resource.", "flatPath": "v1beta2/organizations/{organizationsId}/securityCenterSettings", @@ -1099,6 +1149,31 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "getOnboardingState": { + "description": "Retrieve the OnboardingState of a resource.", + "flatPath": "v1beta2/projects/{projectsId}/onboardingState", + "httpMethod": "GET", + "id": "securitycenter.projects.getOnboardingState", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the OnboardingState to retrieve. Formats: * organizations/{organization}/onboardingState * folders/{folder}/onboardingState * projects/{project}/onboardingState", + "location": "path", + "pattern": "^projects/[^/]+/onboardingState$", + "required": true, + "type": "string" + } + }, + "path": "v1beta2/{+name}", + "response": { + "$ref": "OnboardingState" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "getSecurityHealthAnalyticsSettings": { "description": "Get the SecurityHealthAnalyticsSettings resource.", "flatPath": "v1beta2/projects/{projectsId}/securityHealthAnalyticsSettings", @@ -1592,7 +1667,7 @@ } } }, - "revision": "20220324", + "revision": "20220401", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -1997,6 +2072,13 @@ ], "type": "string" }, + "iamBindings": { + "description": "Represents IAM bindings associated with the Finding.", + "items": { + "$ref": "IamBinding" + }, + "type": "array" + }, "indicator": { "$ref": "Indicator", "description": "Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise" @@ -2035,6 +2117,10 @@ "description": "The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: \"organizations/{organization_id}/sources/{source_id}/findings/{finding_id}\"", "type": "string" }, + "nextSteps": { + "description": "Next steps associate to the finding.", + "type": "string" + }, "parent": { "description": "The relative resource name of the source the finding belongs to. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name This field is immutable after creation time. For example: \"organizations/{organization_id}/sources/{source_id}\"", "type": "string" @@ -2564,6 +2650,35 @@ }, "type": "object" }, + "IamBinding": { + "description": "Represents a particular IAM binding, which captures a member's role addition, removal, or state.", + "id": "IamBinding", + "properties": { + "action": { + "description": "The action that was performed on a Binding.", + "enum": [ + "ACTION_UNSPECIFIED", + "ADD", + "REMOVE" + ], + "enumDescriptions": [ + "Unspecified.", + "Addition of a Binding.", + "Removal of a Binding." + ], + "type": "string" + }, + "member": { + "description": "A single identity requesting access for a Cloud Platform resource, e.g. \"foo@google.com\".", + "type": "string" + }, + "role": { + "description": "Role that is assigned to \"members\". For example, \"roles/viewer\", \"roles/editor\", or \"roles/owner\".", + "type": "string" + } + }, + "type": "object" + }, "Indicator": { "description": "Represents what's commonly known as an Indicator of compromise (IoC) in computer forensics. This is an artifact observed on a network or in an operating system that, with high confidence, indicates a computer intrusion. Reference: https://en.wikipedia.org/wiki/Indicator_of_compromise", "id": "Indicator", @@ -2817,6 +2932,31 @@ }, "type": "object" }, + "OnboardingState": { + "description": "Resource capturing onboarding information for a given CRM resource.", + "id": "OnboardingState", + "properties": { + "name": { + "description": "The resource name of the OnboardingState. Format: organizations/{organization}/onboardingState Format: folders/{folder}/onboardingState Format: projects/{project}/onboardingState", + "type": "string" + }, + "onboardingLevel": { + "description": "Describes the level a given organization, folder, or project is onboarded with SCC. If the resource wasn't onboarded, NOT_FOUND would have been thrown.", + "enum": [ + "ONBOARDING_LEVEL_UNSPECIFIED", + "ONBOARDING_LEVEL_PROJECT", + "ONBOARDING_LEVEL_ORGANIZATION" + ], + "enumDescriptions": [ + "Unused.", + "This resource is onboarded at the project level. Only possible for projects.", + "This resource is onboarded at the organization level. Possible for organizations, folders, and projects." + ], + "type": "string" + } + }, + "type": "object" + }, "Reference": { "description": "Additional Links", "id": "Reference", diff --git a/securitycenter/v1beta2/securitycenter-gen.go b/securitycenter/v1beta2/securitycenter-gen.go index da44407c30f..a9c9ae6b3e9 100644 --- a/securitycenter/v1beta2/securitycenter-gen.go +++ b/securitycenter/v1beta2/securitycenter-gen.go @@ -900,6 +900,9 @@ type Finding struct { // functionality. FindingClass string `json:"findingClass,omitempty"` + // IamBindings: Represents IAM bindings associated with the Finding. + IamBindings []*IamBinding `json:"iamBindings,omitempty"` + // Indicator: Represents what's commonly known as an Indicator of // compromise (IoC) in computer forensics. This is an artifact observed // on a network or in an operating system that, with high confidence, @@ -939,6 +942,9 @@ type Finding struct { // _id}" Name string `json:"name,omitempty"` + // NextSteps: Next steps associate to the finding. + NextSteps string `json:"nextSteps,omitempty"` + // Parent: The relative resource name of the source the finding belongs // to. See: // https://cloud.google.com/apis/design/resource_names#relative_resource_name @@ -1815,6 +1821,48 @@ func (s *GoogleCloudSecuritycenterV1p1beta1SecurityMarks) MarshalJSON() ([]byte, return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// IamBinding: Represents a particular IAM binding, which captures a +// member's role addition, removal, or state. +type IamBinding struct { + // Action: The action that was performed on a Binding. + // + // Possible values: + // "ACTION_UNSPECIFIED" - Unspecified. + // "ADD" - Addition of a Binding. + // "REMOVE" - Removal of a Binding. + Action string `json:"action,omitempty"` + + // Member: A single identity requesting access for a Cloud Platform + // resource, e.g. "foo@google.com". + Member string `json:"member,omitempty"` + + // Role: Role that is assigned to "members". For example, + // "roles/viewer", "roles/editor", or "roles/owner". + 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 *IamBinding) MarshalJSON() ([]byte, error) { + type NoMethod IamBinding + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Indicator: Represents what's commonly known as an Indicator of // compromise (IoC) in computer forensics. This is an artifact observed // on a network or in an operating system that, with high confidence, @@ -2001,6 +2049,55 @@ func (s *MitreAttack) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// OnboardingState: Resource capturing onboarding information for a +// given CRM resource. +type OnboardingState struct { + // Name: The resource name of the OnboardingState. Format: + // organizations/{organization}/onboardingState Format: + // folders/{folder}/onboardingState Format: + // projects/{project}/onboardingState + Name string `json:"name,omitempty"` + + // OnboardingLevel: Describes the level a given organization, folder, or + // project is onboarded with SCC. If the resource wasn't onboarded, + // NOT_FOUND would have been thrown. + // + // Possible values: + // "ONBOARDING_LEVEL_UNSPECIFIED" - Unused. + // "ONBOARDING_LEVEL_PROJECT" - This resource is onboarded at the + // project level. Only possible for projects. + // "ONBOARDING_LEVEL_ORGANIZATION" - This resource is onboarded at the + // organization level. Possible for organizations, folders, and + // projects. + OnboardingLevel string `json:"onboardingLevel,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Name") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. 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. "Name") 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 *OnboardingState) MarshalJSON() ([]byte, error) { + type NoMethod OnboardingState + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Reference: Additional Links type Reference struct { // Source: Source of the reference e.g. NVD @@ -2696,6 +2793,155 @@ func (c *FoldersGetEventThreatDetectionSettingsCall) Do(opts ...googleapi.CallOp } +// method id "securitycenter.folders.getOnboardingState": + +type FoldersGetOnboardingStateCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetOnboardingState: Retrieve the OnboardingState of a resource. +// +// - name: The name of the OnboardingState to retrieve. Formats: * +// organizations/{organization}/onboardingState * +// folders/{folder}/onboardingState * +// projects/{project}/onboardingState. +func (r *FoldersService) GetOnboardingState(name string) *FoldersGetOnboardingStateCall { + c := &FoldersGetOnboardingStateCall{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 *FoldersGetOnboardingStateCall) Fields(s ...googleapi.Field) *FoldersGetOnboardingStateCall { + 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 *FoldersGetOnboardingStateCall) IfNoneMatch(entityTag string) *FoldersGetOnboardingStateCall { + 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 *FoldersGetOnboardingStateCall) Context(ctx context.Context) *FoldersGetOnboardingStateCall { + 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 *FoldersGetOnboardingStateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *FoldersGetOnboardingStateCall) 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, "v1beta2/{+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 "securitycenter.folders.getOnboardingState" call. +// Exactly one of *OnboardingState or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *OnboardingState.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 *FoldersGetOnboardingStateCall) Do(opts ...googleapi.CallOption) (*OnboardingState, 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 := &OnboardingState{ + 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": "Retrieve the OnboardingState of a resource.", + // "flatPath": "v1beta2/folders/{foldersId}/onboardingState", + // "httpMethod": "GET", + // "id": "securitycenter.folders.getOnboardingState", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The name of the OnboardingState to retrieve. Formats: * organizations/{organization}/onboardingState * folders/{folder}/onboardingState * projects/{project}/onboardingState", + // "location": "path", + // "pattern": "^folders/[^/]+/onboardingState$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1beta2/{+name}", + // "response": { + // "$ref": "OnboardingState" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "securitycenter.folders.getSecurityHealthAnalyticsSettings": type FoldersGetSecurityHealthAnalyticsSettingsCall struct { @@ -5013,6 +5259,155 @@ func (c *OrganizationsGetEventThreatDetectionSettingsCall) Do(opts ...googleapi. } +// method id "securitycenter.organizations.getOnboardingState": + +type OrganizationsGetOnboardingStateCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetOnboardingState: Retrieve the OnboardingState of a resource. +// +// - name: The name of the OnboardingState to retrieve. Formats: * +// organizations/{organization}/onboardingState * +// folders/{folder}/onboardingState * +// projects/{project}/onboardingState. +func (r *OrganizationsService) GetOnboardingState(name string) *OrganizationsGetOnboardingStateCall { + c := &OrganizationsGetOnboardingStateCall{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 *OrganizationsGetOnboardingStateCall) Fields(s ...googleapi.Field) *OrganizationsGetOnboardingStateCall { + 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 *OrganizationsGetOnboardingStateCall) IfNoneMatch(entityTag string) *OrganizationsGetOnboardingStateCall { + 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 *OrganizationsGetOnboardingStateCall) Context(ctx context.Context) *OrganizationsGetOnboardingStateCall { + 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 *OrganizationsGetOnboardingStateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsGetOnboardingStateCall) 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, "v1beta2/{+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 "securitycenter.organizations.getOnboardingState" call. +// Exactly one of *OnboardingState or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *OnboardingState.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 *OrganizationsGetOnboardingStateCall) Do(opts ...googleapi.CallOption) (*OnboardingState, 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 := &OnboardingState{ + 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": "Retrieve the OnboardingState of a resource.", + // "flatPath": "v1beta2/organizations/{organizationsId}/onboardingState", + // "httpMethod": "GET", + // "id": "securitycenter.organizations.getOnboardingState", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The name of the OnboardingState to retrieve. Formats: * organizations/{organization}/onboardingState * folders/{folder}/onboardingState * projects/{project}/onboardingState", + // "location": "path", + // "pattern": "^organizations/[^/]+/onboardingState$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1beta2/{+name}", + // "response": { + // "$ref": "OnboardingState" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "securitycenter.organizations.getSecurityCenterSettings": type OrganizationsGetSecurityCenterSettingsCall struct { @@ -7624,6 +8019,155 @@ func (c *ProjectsGetEventThreatDetectionSettingsCall) Do(opts ...googleapi.CallO } +// method id "securitycenter.projects.getOnboardingState": + +type ProjectsGetOnboardingStateCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetOnboardingState: Retrieve the OnboardingState of a resource. +// +// - name: The name of the OnboardingState to retrieve. Formats: * +// organizations/{organization}/onboardingState * +// folders/{folder}/onboardingState * +// projects/{project}/onboardingState. +func (r *ProjectsService) GetOnboardingState(name string) *ProjectsGetOnboardingStateCall { + c := &ProjectsGetOnboardingStateCall{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 *ProjectsGetOnboardingStateCall) Fields(s ...googleapi.Field) *ProjectsGetOnboardingStateCall { + 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 *ProjectsGetOnboardingStateCall) IfNoneMatch(entityTag string) *ProjectsGetOnboardingStateCall { + 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 *ProjectsGetOnboardingStateCall) Context(ctx context.Context) *ProjectsGetOnboardingStateCall { + 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 *ProjectsGetOnboardingStateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsGetOnboardingStateCall) 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, "v1beta2/{+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 "securitycenter.projects.getOnboardingState" call. +// Exactly one of *OnboardingState or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *OnboardingState.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 *ProjectsGetOnboardingStateCall) Do(opts ...googleapi.CallOption) (*OnboardingState, 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 := &OnboardingState{ + 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": "Retrieve the OnboardingState of a resource.", + // "flatPath": "v1beta2/projects/{projectsId}/onboardingState", + // "httpMethod": "GET", + // "id": "securitycenter.projects.getOnboardingState", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The name of the OnboardingState to retrieve. Formats: * organizations/{organization}/onboardingState * folders/{folder}/onboardingState * projects/{project}/onboardingState", + // "location": "path", + // "pattern": "^projects/[^/]+/onboardingState$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1beta2/{+name}", + // "response": { + // "$ref": "OnboardingState" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "securitycenter.projects.getSecurityHealthAnalyticsSettings": type ProjectsGetSecurityHealthAnalyticsSettingsCall struct { diff --git a/serviceconsumermanagement/v1/serviceconsumermanagement-api.json b/serviceconsumermanagement/v1/serviceconsumermanagement-api.json index eaa96c97744..10d7c1f0339 100644 --- a/serviceconsumermanagement/v1/serviceconsumermanagement-api.json +++ b/serviceconsumermanagement/v1/serviceconsumermanagement-api.json @@ -542,7 +542,7 @@ } } }, - "revision": "20220321", + "revision": "20220405", "rootUrl": "https://serviceconsumermanagement.googleapis.com/", "schemas": { "AddTenantProjectRequest": { @@ -671,7 +671,7 @@ "type": "string" }, "jwtLocations": { - "description": "Defines the locations to extract the JWT. JWT locations can be either from HTTP headers or URL query parameters. The rule is that the first match wins. The checking order is: checking all headers first, then URL query parameters. If not specified, default to use following 3 locations: 1) Authorization: Bearer 2) x-goog-iap-jwt-assertion 3) access_token query parameter Default locations can be specified as followings: jwt_locations: - header: Authorization value_prefix: \"Bearer \" - header: x-goog-iap-jwt-assertion - query: access_token", + "description": "Defines the locations to extract the JWT. For now it is only used by the Cloud Endpoints to store the OpenAPI extension [x-google-jwt-locations] (https://cloud.google.com/endpoints/docs/openapi/openapi-extensions#x-google-jwt-locations) JWT locations can be one of HTTP headers, URL query parameters or cookies. The rule is that the first match wins. If not specified, default to use following 3 locations: 1) Authorization: Bearer 2) x-goog-iap-jwt-assertion 3) access_token query parameter Default locations can be specified as followings: jwt_locations: - header: Authorization value_prefix: \"Bearer \" - header: x-goog-iap-jwt-assertion - query: access_token", "items": { "$ref": "JwtLocation" }, @@ -1315,6 +1315,10 @@ "description": "Specifies a location to extract JWT from an API request.", "id": "JwtLocation", "properties": { + "cookie": { + "description": "Specifies cookie name to extract JWT token.", + "type": "string" + }, "header": { "description": "Specifies HTTP header name to extract JWT token.", "type": "string" diff --git a/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go index fa840c23706..920d590ffaf 100644 --- a/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go +++ b/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go @@ -398,11 +398,13 @@ type AuthProvider struct { // https://www.googleapis.com/oauth2/v1/certs JwksUri string `json:"jwksUri,omitempty"` - // JwtLocations: Defines the locations to extract the JWT. JWT locations - // can be either from HTTP headers or URL query parameters. The rule is - // that the first match wins. The checking order is: checking all - // headers first, then URL query parameters. If not specified, default - // to use following 3 locations: 1) Authorization: Bearer 2) + // JwtLocations: Defines the locations to extract the JWT. For now it is + // only used by the Cloud Endpoints to store the OpenAPI extension + // [x-google-jwt-locations] + // (https://cloud.google.com/endpoints/docs/openapi/openapi-extensions#x-google-jwt-locations) + // JWT locations can be one of HTTP headers, URL query parameters or + // cookies. The rule is that the first match wins. If not specified, + // default to use following 3 locations: 1) Authorization: Bearer 2) // x-goog-iap-jwt-assertion 3) access_token query parameter Default // locations can be specified as followings: jwt_locations: - header: // Authorization value_prefix: "Bearer " - header: @@ -1767,6 +1769,9 @@ func (s *HttpRule) MarshalJSON() ([]byte, error) { // JwtLocation: Specifies a location to extract JWT from an API request. type JwtLocation struct { + // Cookie: Specifies cookie name to extract JWT token. + Cookie string `json:"cookie,omitempty"` + // Header: Specifies HTTP header name to extract JWT token. Header string `json:"header,omitempty"` @@ -1782,7 +1787,7 @@ type JwtLocation struct { // value_prefix="Bearer " with a space at the end. ValuePrefix string `json:"valuePrefix,omitempty"` - // ForceSendFields is a list of field names (e.g. "Header") to + // ForceSendFields is a list of field names (e.g. "Cookie") 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 @@ -1790,7 +1795,7 @@ type JwtLocation struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Header") to include in API + // NullFields is a list of field names (e.g. "Cookie") 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 diff --git a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json index 76c49765047..a56701a6ee2 100644 --- a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json +++ b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json @@ -500,7 +500,7 @@ } } }, - "revision": "20220321", + "revision": "20220405", "rootUrl": "https://serviceconsumermanagement.googleapis.com/", "schemas": { "Api": { @@ -580,7 +580,7 @@ "type": "string" }, "jwtLocations": { - "description": "Defines the locations to extract the JWT. JWT locations can be either from HTTP headers or URL query parameters. The rule is that the first match wins. The checking order is: checking all headers first, then URL query parameters. If not specified, default to use following 3 locations: 1) Authorization: Bearer 2) x-goog-iap-jwt-assertion 3) access_token query parameter Default locations can be specified as followings: jwt_locations: - header: Authorization value_prefix: \"Bearer \" - header: x-goog-iap-jwt-assertion - query: access_token", + "description": "Defines the locations to extract the JWT. For now it is only used by the Cloud Endpoints to store the OpenAPI extension [x-google-jwt-locations] (https://cloud.google.com/endpoints/docs/openapi/openapi-extensions#x-google-jwt-locations) JWT locations can be one of HTTP headers, URL query parameters or cookies. The rule is that the first match wins. If not specified, default to use following 3 locations: 1) Authorization: Bearer 2) x-goog-iap-jwt-assertion 3) access_token query parameter Default locations can be specified as followings: jwt_locations: - header: Authorization value_prefix: \"Bearer \" - header: x-goog-iap-jwt-assertion - query: access_token", "items": { "$ref": "JwtLocation" }, @@ -1185,6 +1185,10 @@ "description": "Specifies a location to extract JWT from an API request.", "id": "JwtLocation", "properties": { + "cookie": { + "description": "Specifies cookie name to extract JWT token.", + "type": "string" + }, "header": { "description": "Specifies HTTP header name to extract JWT token.", "type": "string" diff --git a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go index dde66d95b16..5ad752dd484 100644 --- a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go +++ b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go @@ -313,11 +313,13 @@ type AuthProvider struct { // https://www.googleapis.com/oauth2/v1/certs JwksUri string `json:"jwksUri,omitempty"` - // JwtLocations: Defines the locations to extract the JWT. JWT locations - // can be either from HTTP headers or URL query parameters. The rule is - // that the first match wins. The checking order is: checking all - // headers first, then URL query parameters. If not specified, default - // to use following 3 locations: 1) Authorization: Bearer 2) + // JwtLocations: Defines the locations to extract the JWT. For now it is + // only used by the Cloud Endpoints to store the OpenAPI extension + // [x-google-jwt-locations] + // (https://cloud.google.com/endpoints/docs/openapi/openapi-extensions#x-google-jwt-locations) + // JWT locations can be one of HTTP headers, URL query parameters or + // cookies. The rule is that the first match wins. If not specified, + // default to use following 3 locations: 1) Authorization: Bearer 2) // x-goog-iap-jwt-assertion 3) access_token query parameter Default // locations can be specified as followings: jwt_locations: - header: // Authorization value_prefix: "Bearer " - header: @@ -1578,6 +1580,9 @@ func (s *HttpRule) MarshalJSON() ([]byte, error) { // JwtLocation: Specifies a location to extract JWT from an API request. type JwtLocation struct { + // Cookie: Specifies cookie name to extract JWT token. + Cookie string `json:"cookie,omitempty"` + // Header: Specifies HTTP header name to extract JWT token. Header string `json:"header,omitempty"` @@ -1593,7 +1598,7 @@ type JwtLocation struct { // value_prefix="Bearer " with a space at the end. ValuePrefix string `json:"valuePrefix,omitempty"` - // ForceSendFields is a list of field names (e.g. "Header") to + // ForceSendFields is a list of field names (e.g. "Cookie") 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 @@ -1601,7 +1606,7 @@ type JwtLocation struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Header") to include in API + // NullFields is a list of field names (e.g. "Cookie") 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 diff --git a/servicemanagement/v1/servicemanagement-api.json b/servicemanagement/v1/servicemanagement-api.json index 98219113e72..bcefc1bb1e6 100644 --- a/servicemanagement/v1/servicemanagement-api.json +++ b/servicemanagement/v1/servicemanagement-api.json @@ -213,7 +213,7 @@ ], "parameters": { "serviceName": { - "description": "Required. The name of the service. See the [overview](/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", + "description": "Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", "location": "path", "required": true, "type": "string" @@ -289,7 +289,7 @@ "type": "string" }, "serviceName": { - "description": "Required. The name of the service. See the [overview](/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", + "description": "Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", "location": "path", "required": true, "type": "string" @@ -460,7 +460,7 @@ ], "parameters": { "serviceName": { - "description": "Required. The name of the service. See the [overview](/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", + "description": "Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", "location": "path", "required": true, "type": "string" @@ -489,7 +489,7 @@ ], "parameters": { "serviceName": { - "description": "Required. The name of the service. See the [overview](/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", + "description": "Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", "location": "path", "required": true, "type": "string" @@ -524,7 +524,7 @@ "type": "string" }, "serviceName": { - "description": "Required. The name of the service. See the [overview](/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", + "description": "Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", "location": "path", "required": true, "type": "string" @@ -575,7 +575,7 @@ "type": "string" }, "serviceName": { - "description": "Required. The name of the service. See the [overview](/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", + "description": "Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", "location": "path", "required": true, "type": "string" @@ -602,7 +602,7 @@ ], "parameters": { "serviceName": { - "description": "Required. The name of the service. See the [overview](/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", + "description": "Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", "location": "path", "required": true, "type": "string" @@ -729,7 +729,7 @@ ], "parameters": { "serviceName": { - "description": "Required. The name of the service. See the [overview](/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", + "description": "Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", "location": "path", "required": true, "type": "string" @@ -764,7 +764,7 @@ "type": "string" }, "serviceName": { - "description": "Required. The name of the service. See the [overview](/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", + "description": "Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", "location": "path", "required": true, "type": "string" @@ -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](google.api.servicemanagement.v1.RolloutStatus) 'SUCCESS', use filter='status=SUCCESS' -- To limit the results to those in [status](google.api.servicemanagement.v1.RolloutStatus) 'CANCELLED' or 'FAILED', use filter='status=CANCELLED OR status=FAILED'", + "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'", "location": "query", "type": "string" }, @@ -807,7 +807,7 @@ "type": "string" }, "serviceName": { - "description": "Required. The name of the service. See the [overview](/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", + "description": "Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", "location": "path", "required": true, "type": "string" @@ -829,7 +829,7 @@ } } }, - "revision": "20220218", + "revision": "20220401", "rootUrl": "https://servicemanagement.googleapis.com/", "schemas": { "Advice": { @@ -2046,7 +2046,7 @@ "type": "string" }, "serviceName": { - "description": "The name of the service. See the [overview](/service-management/overview) for naming requirements.", + "description": "The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements.", "type": "string" } }, diff --git a/servicemanagement/v1/servicemanagement-gen.go b/servicemanagement/v1/servicemanagement-gen.go index 1f1f813ad1e..536c6ca38f2 100644 --- a/servicemanagement/v1/servicemanagement-gen.go +++ b/servicemanagement/v1/servicemanagement-gen.go @@ -2657,7 +2657,8 @@ type ManagedService struct { ProducerProjectId string `json:"producerProjectId,omitempty"` // ServiceName: The name of the service. See the overview - // (/service-management/overview) for naming requirements. + // (https://cloud.google.com/service-management/overview) for naming + // requirements. ServiceName string `json:"serviceName,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -5293,8 +5294,8 @@ type ServicesDeleteCall struct { // After 30 days, the service will be permanently deleted. Operation // // - serviceName: The name of the service. See the overview -// (/service-management/overview) for naming requirements. For -// example: `example.googleapis.com`. +// (https://cloud.google.com/service-management/overview) for naming +// requirements. For example: `example.googleapis.com`. func (r *ServicesService) Delete(serviceName string) *ServicesDeleteCall { c := &ServicesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName @@ -5396,7 +5397,7 @@ func (c *ServicesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error // ], // "parameters": { // "serviceName": { - // "description": "Required. The name of the service. See the [overview](/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", + // "description": "Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", // "location": "path", // "required": true, // "type": "string" @@ -5715,8 +5716,8 @@ type ServicesGetConfigCall struct { // service. // // - serviceName: The name of the service. See the overview -// (/service-management/overview) for naming requirements. For -// example: `example.googleapis.com`. +// (https://cloud.google.com/service-management/overview) for naming +// requirements. For example: `example.googleapis.com`. func (r *ServicesService) GetConfig(serviceName string) *ServicesGetConfigCall { c := &ServicesGetConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName @@ -5858,7 +5859,7 @@ func (c *ServicesGetConfigCall) Do(opts ...googleapi.CallOption) (*Service, erro // "type": "string" // }, // "serviceName": { - // "description": "Required. The name of the service. See the [overview](/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", + // "description": "Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", // "location": "path", // "required": true, // "type": "string" @@ -6562,8 +6563,8 @@ type ServicesUndeleteCall struct { // within the last 30 days. Operation // // - serviceName: The name of the service. See the overview -// (/service-management/overview) for naming requirements. For -// example: `example.googleapis.com`. +// (https://cloud.google.com/service-management/overview) for naming +// requirements. For example: `example.googleapis.com`. func (r *ServicesService) Undelete(serviceName string) *ServicesUndeleteCall { c := &ServicesUndeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName @@ -6665,7 +6666,7 @@ func (c *ServicesUndeleteCall) Do(opts ...googleapi.CallOption) (*Operation, err // ], // "parameters": { // "serviceName": { - // "description": "Required. The name of the service. See the [overview](/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", + // "description": "Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", // "location": "path", // "required": true, // "type": "string" @@ -6702,8 +6703,8 @@ type ServicesConfigsCreateCall struct { // The rest will be deleted eventually. // // - serviceName: The name of the service. See the overview -// (/service-management/overview) for naming requirements. For -// example: `example.googleapis.com`. +// (https://cloud.google.com/service-management/overview) for naming +// requirements. For example: `example.googleapis.com`. func (r *ServicesConfigsService) Create(serviceName string, service *Service) *ServicesConfigsCreateCall { c := &ServicesConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName @@ -6811,7 +6812,7 @@ func (c *ServicesConfigsCreateCall) Do(opts ...googleapi.CallOption) (*Service, // ], // "parameters": { // "serviceName": { - // "description": "Required. The name of the service. See the [overview](/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", + // "description": "Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", // "location": "path", // "required": true, // "type": "string" @@ -6850,8 +6851,8 @@ type ServicesConfigsGetCall struct { // must be specified for the server to return all fields, including // `SourceInfo`. // - serviceName: The name of the service. See the overview -// (/service-management/overview) for naming requirements. For -// example: `example.googleapis.com`. +// (https://cloud.google.com/service-management/overview) for naming +// requirements. For example: `example.googleapis.com`. func (r *ServicesConfigsService) Get(serviceName string, configId string) *ServicesConfigsGetCall { c := &ServicesConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName @@ -6989,7 +6990,7 @@ func (c *ServicesConfigsGetCall) Do(opts ...googleapi.CallOption) (*Service, err // "type": "string" // }, // "serviceName": { - // "description": "Required. The name of the service. See the [overview](/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", + // "description": "Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", // "location": "path", // "required": true, // "type": "string" @@ -7037,8 +7038,8 @@ type ServicesConfigsListCall struct { // service, from the newest to the oldest. // // - serviceName: The name of the service. See the overview -// (/service-management/overview) for naming requirements. For -// example: `example.googleapis.com`. +// (https://cloud.google.com/service-management/overview) for naming +// requirements. For example: `example.googleapis.com`. func (r *ServicesConfigsService) List(serviceName string) *ServicesConfigsListCall { c := &ServicesConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName @@ -7179,7 +7180,7 @@ func (c *ServicesConfigsListCall) Do(opts ...googleapi.CallOption) (*ListService // "type": "string" // }, // "serviceName": { - // "description": "Required. The name of the service. See the [overview](/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", + // "description": "Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", // "location": "path", // "required": true, // "type": "string" @@ -7241,8 +7242,8 @@ type ServicesConfigsSubmitCall struct { // each service. The rest will be deleted eventually. Operation // // - serviceName: The name of the service. See the overview -// (/service-management/overview) for naming requirements. For -// example: `example.googleapis.com`. +// (https://cloud.google.com/service-management/overview) for naming +// requirements. For example: `example.googleapis.com`. func (r *ServicesConfigsService) Submit(serviceName string, submitconfigsourcerequest *SubmitConfigSourceRequest) *ServicesConfigsSubmitCall { c := &ServicesConfigsSubmitCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName @@ -7350,7 +7351,7 @@ func (c *ServicesConfigsSubmitCall) Do(opts ...googleapi.CallOption) (*Operation // ], // "parameters": { // "serviceName": { - // "description": "Required. The name of the service. See the [overview](/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", + // "description": "Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", // "location": "path", // "required": true, // "type": "string" @@ -7842,8 +7843,8 @@ type ServicesRolloutsCreateCall struct { // will be deleted eventually. Operation // // - serviceName: The name of the service. See the overview -// (/service-management/overview) for naming requirements. For -// example: `example.googleapis.com`. +// (https://cloud.google.com/service-management/overview) for naming +// requirements. For example: `example.googleapis.com`. func (r *ServicesRolloutsService) Create(serviceName string, rollout *Rollout) *ServicesRolloutsCreateCall { c := &ServicesRolloutsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName @@ -7951,7 +7952,7 @@ func (c *ServicesRolloutsCreateCall) Do(opts ...googleapi.CallOption) (*Operatio // ], // "parameters": { // "serviceName": { - // "description": "Required. The name of the service. See the [overview](/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", + // "description": "Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", // "location": "path", // "required": true, // "type": "string" @@ -7988,8 +7989,8 @@ type ServicesRolloutsGetCall struct { // // - rolloutId: The id of the rollout resource. // - serviceName: The name of the service. See the overview -// (/service-management/overview) for naming requirements. For -// example: `example.googleapis.com`. +// (https://cloud.google.com/service-management/overview) for naming +// requirements. For example: `example.googleapis.com`. func (r *ServicesRolloutsService) Get(serviceName string, rolloutId string) *ServicesRolloutsGetCall { c := &ServicesRolloutsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName @@ -8113,7 +8114,7 @@ func (c *ServicesRolloutsGetCall) Do(opts ...googleapi.CallOption) (*Rollout, er // "type": "string" // }, // "serviceName": { - // "description": "Required. The name of the service. See the [overview](/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", + // "description": "Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", // "location": "path", // "required": true, // "type": "string" @@ -8148,8 +8149,8 @@ type ServicesRolloutsListCall struct { // managed service, from the newest to the oldest. // // - serviceName: The name of the service. See the overview -// (/service-management/overview) for naming requirements. For -// example: `example.googleapis.com`. +// (https://cloud.google.com/service-management/overview) for naming +// requirements. For example: `example.googleapis.com`. func (r *ServicesRolloutsService) List(serviceName string) *ServicesRolloutsListCall { c := &ServicesRolloutsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.serviceName = serviceName @@ -8158,11 +8159,10 @@ 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 -// (google.api.servicemanagement.v1.RolloutStatus) 'SUCCESS', use +// To limit the results to only those in status 'SUCCESS', use // filter='status=SUCCESS' -- To limit the results to those in status -// (google.api.servicemanagement.v1.RolloutStatus) 'CANCELLED' or -// 'FAILED', use filter='status=CANCELLED OR status=FAILED' +// 'CANCELLED' or 'FAILED', use filter='status=CANCELLED OR +// status=FAILED' func (c *ServicesRolloutsListCall) Filter(filter string) *ServicesRolloutsListCall { c.urlParams_.Set("filter", filter) return c @@ -8291,7 +8291,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](google.api.servicemanagement.v1.RolloutStatus) 'SUCCESS', use filter='status=SUCCESS' -- To limit the results to those in [status](google.api.servicemanagement.v1.RolloutStatus) 'CANCELLED' or 'FAILED', use filter='status=CANCELLED OR status=FAILED'", + // "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'", // "location": "query", // "type": "string" // }, @@ -8307,7 +8307,7 @@ func (c *ServicesRolloutsListCall) Do(opts ...googleapi.CallOption) (*ListServic // "type": "string" // }, // "serviceName": { - // "description": "Required. The name of the service. See the [overview](/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", + // "description": "Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements. For example: `example.googleapis.com`.", // "location": "path", // "required": true, // "type": "string" diff --git a/serviceusage/v1/serviceusage-api.json b/serviceusage/v1/serviceusage-api.json index c61587f0e13..8728866d59a 100644 --- a/serviceusage/v1/serviceusage-api.json +++ b/serviceusage/v1/serviceusage-api.json @@ -426,7 +426,7 @@ } } }, - "revision": "20220321", + "revision": "20220405", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AdminQuotaPolicy": { @@ -541,7 +541,7 @@ "type": "string" }, "jwtLocations": { - "description": "Defines the locations to extract the JWT. JWT locations can be either from HTTP headers or URL query parameters. The rule is that the first match wins. The checking order is: checking all headers first, then URL query parameters. If not specified, default to use following 3 locations: 1) Authorization: Bearer 2) x-goog-iap-jwt-assertion 3) access_token query parameter Default locations can be specified as followings: jwt_locations: - header: Authorization value_prefix: \"Bearer \" - header: x-goog-iap-jwt-assertion - query: access_token", + "description": "Defines the locations to extract the JWT. For now it is only used by the Cloud Endpoints to store the OpenAPI extension [x-google-jwt-locations] (https://cloud.google.com/endpoints/docs/openapi/openapi-extensions#x-google-jwt-locations) JWT locations can be one of HTTP headers, URL query parameters or cookies. The rule is that the first match wins. If not specified, default to use following 3 locations: 1) Authorization: Bearer 2) x-goog-iap-jwt-assertion 3) access_token query parameter Default locations can be specified as followings: jwt_locations: - header: Authorization value_prefix: \"Bearer \" - header: x-goog-iap-jwt-assertion - query: access_token", "items": { "$ref": "JwtLocation" }, @@ -1679,6 +1679,10 @@ "description": "Specifies a location to extract JWT from an API request.", "id": "JwtLocation", "properties": { + "cookie": { + "description": "Specifies cookie name to extract JWT token.", + "type": "string" + }, "header": { "description": "Specifies HTTP header name to extract JWT token.", "type": "string" diff --git a/serviceusage/v1/serviceusage-gen.go b/serviceusage/v1/serviceusage-gen.go index 0b13f588be3..2f69383fdc9 100644 --- a/serviceusage/v1/serviceusage-gen.go +++ b/serviceusage/v1/serviceusage-gen.go @@ -351,11 +351,13 @@ type AuthProvider struct { // https://www.googleapis.com/oauth2/v1/certs JwksUri string `json:"jwksUri,omitempty"` - // JwtLocations: Defines the locations to extract the JWT. JWT locations - // can be either from HTTP headers or URL query parameters. The rule is - // that the first match wins. The checking order is: checking all - // headers first, then URL query parameters. If not specified, default - // to use following 3 locations: 1) Authorization: Bearer 2) + // JwtLocations: Defines the locations to extract the JWT. For now it is + // only used by the Cloud Endpoints to store the OpenAPI extension + // [x-google-jwt-locations] + // (https://cloud.google.com/endpoints/docs/openapi/openapi-extensions#x-google-jwt-locations) + // JWT locations can be one of HTTP headers, URL query parameters or + // cookies. The rule is that the first match wins. If not specified, + // default to use following 3 locations: 1) Authorization: Bearer 2) // x-goog-iap-jwt-assertion 3) access_token query parameter Default // locations can be specified as followings: jwt_locations: - header: // Authorization value_prefix: "Bearer " - header: @@ -2473,6 +2475,9 @@ func (s *ImportConsumerOverridesResponse) MarshalJSON() ([]byte, error) { // JwtLocation: Specifies a location to extract JWT from an API request. type JwtLocation struct { + // Cookie: Specifies cookie name to extract JWT token. + Cookie string `json:"cookie,omitempty"` + // Header: Specifies HTTP header name to extract JWT token. Header string `json:"header,omitempty"` @@ -2488,7 +2493,7 @@ type JwtLocation struct { // value_prefix="Bearer " with a space at the end. ValuePrefix string `json:"valuePrefix,omitempty"` - // ForceSendFields is a list of field names (e.g. "Header") to + // ForceSendFields is a list of field names (e.g. "Cookie") 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 @@ -2496,7 +2501,7 @@ type JwtLocation struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Header") to include in API + // NullFields is a list of field names (e.g. "Cookie") 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 diff --git a/serviceusage/v1beta1/serviceusage-api.json b/serviceusage/v1beta1/serviceusage-api.json index 02c6f7c3a62..8cde0c74b7e 100644 --- a/serviceusage/v1beta1/serviceusage-api.json +++ b/serviceusage/v1beta1/serviceusage-api.json @@ -959,7 +959,7 @@ } } }, - "revision": "20220321", + "revision": "20220405", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AdminQuotaPolicy": { @@ -1074,7 +1074,7 @@ "type": "string" }, "jwtLocations": { - "description": "Defines the locations to extract the JWT. JWT locations can be either from HTTP headers or URL query parameters. The rule is that the first match wins. The checking order is: checking all headers first, then URL query parameters. If not specified, default to use following 3 locations: 1) Authorization: Bearer 2) x-goog-iap-jwt-assertion 3) access_token query parameter Default locations can be specified as followings: jwt_locations: - header: Authorization value_prefix: \"Bearer \" - header: x-goog-iap-jwt-assertion - query: access_token", + "description": "Defines the locations to extract the JWT. For now it is only used by the Cloud Endpoints to store the OpenAPI extension [x-google-jwt-locations] (https://cloud.google.com/endpoints/docs/openapi/openapi-extensions#x-google-jwt-locations) JWT locations can be one of HTTP headers, URL query parameters or cookies. The rule is that the first match wins. If not specified, default to use following 3 locations: 1) Authorization: Bearer 2) x-goog-iap-jwt-assertion 3) access_token query parameter Default locations can be specified as followings: jwt_locations: - header: Authorization value_prefix: \"Bearer \" - header: x-goog-iap-jwt-assertion - query: access_token", "items": { "$ref": "JwtLocation" }, @@ -2315,6 +2315,10 @@ "description": "Specifies a location to extract JWT from an API request.", "id": "JwtLocation", "properties": { + "cookie": { + "description": "Specifies cookie name to extract JWT token.", + "type": "string" + }, "header": { "description": "Specifies HTTP header name to extract JWT token.", "type": "string" diff --git a/serviceusage/v1beta1/serviceusage-gen.go b/serviceusage/v1beta1/serviceusage-gen.go index 935eb49e815..167237a9cdb 100644 --- a/serviceusage/v1beta1/serviceusage-gen.go +++ b/serviceusage/v1beta1/serviceusage-gen.go @@ -399,11 +399,13 @@ type AuthProvider struct { // https://www.googleapis.com/oauth2/v1/certs JwksUri string `json:"jwksUri,omitempty"` - // JwtLocations: Defines the locations to extract the JWT. JWT locations - // can be either from HTTP headers or URL query parameters. The rule is - // that the first match wins. The checking order is: checking all - // headers first, then URL query parameters. If not specified, default - // to use following 3 locations: 1) Authorization: Bearer 2) + // JwtLocations: Defines the locations to extract the JWT. For now it is + // only used by the Cloud Endpoints to store the OpenAPI extension + // [x-google-jwt-locations] + // (https://cloud.google.com/endpoints/docs/openapi/openapi-extensions#x-google-jwt-locations) + // JWT locations can be one of HTTP headers, URL query parameters or + // cookies. The rule is that the first match wins. If not specified, + // default to use following 3 locations: 1) Authorization: Bearer 2) // x-goog-iap-jwt-assertion 3) access_token query parameter Default // locations can be specified as followings: jwt_locations: - header: // Authorization value_prefix: "Bearer " - header: @@ -2662,6 +2664,9 @@ func (s *ImportConsumerOverridesResponse) MarshalJSON() ([]byte, error) { // JwtLocation: Specifies a location to extract JWT from an API request. type JwtLocation struct { + // Cookie: Specifies cookie name to extract JWT token. + Cookie string `json:"cookie,omitempty"` + // Header: Specifies HTTP header name to extract JWT token. Header string `json:"header,omitempty"` @@ -2677,7 +2682,7 @@ type JwtLocation struct { // value_prefix="Bearer " with a space at the end. ValuePrefix string `json:"valuePrefix,omitempty"` - // ForceSendFields is a list of field names (e.g. "Header") to + // ForceSendFields is a list of field names (e.g. "Cookie") 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 @@ -2685,7 +2690,7 @@ type JwtLocation struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Header") to include in API + // NullFields is a list of field names (e.g. "Cookie") 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 diff --git a/sourcerepo/v1/sourcerepo-api.json b/sourcerepo/v1/sourcerepo-api.json index 8cd8823e106..5c5b1671310 100644 --- a/sourcerepo/v1/sourcerepo-api.json +++ b/sourcerepo/v1/sourcerepo-api.json @@ -450,7 +450,7 @@ } } }, - "revision": "20220319", + "revision": "20220402", "rootUrl": "https://sourcerepo.googleapis.com/", "schemas": { "AuditConfig": { @@ -510,7 +510,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" }, @@ -743,7 +743,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\"`", @@ -816,7 +816,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/sourcerepo/v1/sourcerepo-gen.go b/sourcerepo/v1/sourcerepo-gen.go index e091e4fe279..e9146df3257 100644 --- a/sourcerepo/v1/sourcerepo-gen.go +++ b/sourcerepo/v1/sourcerepo-gen.go @@ -283,8 +283,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 @@ -808,7 +808,7 @@ func (s *Repo) 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"` @@ -932,7 +932,7 @@ type SyncRepoRequest struct { // 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"` diff --git a/spanner/v1/spanner-api.json b/spanner/v1/spanner-api.json index ea9c5257b03..ec2b7707c6d 100644 --- a/spanner/v1/spanner-api.json +++ b/spanner/v1/spanner-api.json @@ -178,6 +178,132 @@ "https://www.googleapis.com/auth/spanner.admin" ] } + }, + "resources": { + "operations": { + "methods": { + "cancel": { + "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "flatPath": "v1/projects/{projectsId}/instanceConfigs/{instanceConfigsId}/operations/{operationsId}:cancel", + "httpMethod": "POST", + "id": "spanner.projects.instanceConfigs.operations.cancel", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be cancelled.", + "location": "path", + "pattern": "^projects/[^/]+/instanceConfigs/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:cancel", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/spanner.admin" + ] + }, + "delete": { + "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", + "flatPath": "v1/projects/{projectsId}/instanceConfigs/{instanceConfigsId}/operations/{operationsId}", + "httpMethod": "DELETE", + "id": "spanner.projects.instanceConfigs.operations.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be deleted.", + "location": "path", + "pattern": "^projects/[^/]+/instanceConfigs/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/spanner.admin" + ] + }, + "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": "v1/projects/{projectsId}/instanceConfigs/{instanceConfigsId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "spanner.projects.instanceConfigs.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/instanceConfigs/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/spanner.admin" + ] + }, + "list": { + "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to override the binding to use different resource name schemes, such as `users/*/operations`. To override the binding, API services can add a binding such as `\"/v1/{name=users/*}/operations\"` to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id.", + "flatPath": "v1/projects/{projectsId}/instanceConfigs/{instanceConfigsId}/operations", + "httpMethod": "GET", + "id": "spanner.projects.instanceConfigs.operations.list", + "parameterOrder": [ + "name" + ], + "parameters": { + "filter": { + "description": "The standard list filter.", + "location": "query", + "type": "string" + }, + "name": { + "description": "The name of the operation's parent resource.", + "location": "path", + "pattern": "^projects/[^/]+/instanceConfigs/[^/]+/operations$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "ListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/spanner.admin" + ] + } + } + } } }, "instances": { @@ -447,7 +573,7 @@ ], "parameters": { "filter": { - "description": "An expression that filters the list of returned backup operations. A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string, a number, or a boolean. The comparison operator must be one of: `\u003c`, `\u003e`, `\u003c=`, `\u003e=`, `!=`, `=`, or `:`. Colon `:` is the contains operator. Filter rules are not case sensitive. The following fields in the operation are eligible for filtering: * `name` - The name of the long-running operation * `done` - False if the operation is in progress, else true. * `metadata.@type` - the type of metadata. For example, the type string for CreateBackupMetadata is `type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata`. * `metadata.` - any field in metadata.value. `metadata.@type` must be specified first if filtering on metadata fields. * `error` - Error associated with the long-running operation. * `response.@type` - the type of response. * `response.` - any field in response.value. You can combine multiple expressions by enclosing each expression in parentheses. By default, expressions are combined with AND logic, but you can specify AND, OR, and NOT logic explicitly. Here are a few examples: * `done:true` - The operation is complete. * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \\ `metadata.database:prod` - Returns operations where: * The operation's metadata type is CreateBackupMetadata. * The database the backup was taken from has a name containing the string \"prod\". * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \\ `(metadata.name:howl) AND` \\ `(metadata.progress.start_time \u003c \\\"2018-03-28T14:50:00Z\\\") AND` \\ `(error:*)` - Returns operations where: * The operation's metadata type is CreateBackupMetadata. * The backup name contains the string \"howl\". * The operation started before 2018-03-28T14:50:00Z. * The operation resulted in an error. * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CopyBackupMetadata) AND` \\ `(metadata.source_backup:test) AND` \\ `(metadata.progress.start_time \u003c \\\"2022-01-18T14:50:00Z\\\") AND` \\ `(error:*)` - Returns operations where: * The operation's metadata type is CopyBackupMetadata. * The source backup of the copied backup name contains the string \"test\". * The operation started before 2022-01-18T14:50:00Z. * The operation resulted in an error. * `((metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \\ `(metadata.database:test_db)) OR` \\ `((metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CopyBackupMetadata) AND` \\ `(metadata.source_backup:test_bkp)) AND` \\ `(error:*)` - Returns operations where: * The operation's metadata matches either of criteria: * The operation's metadata type is CreateBackupMetadata AND the database the backup was taken from has name containing string \"test_db\" * The operation's metadata type is CopyBackupMetadata AND the backup the backup was copied from has name containing string \"test_bkp\" * The operation resulted in an error.", + "description": "An expression that filters the list of returned backup operations. A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string, a number, or a boolean. The comparison operator must be one of: `\u003c`, `\u003e`, `\u003c=`, `\u003e=`, `!=`, `=`, or `:`. Colon `:` is the contains operator. Filter rules are not case sensitive. The following fields in the operation are eligible for filtering: * `name` - The name of the long-running operation * `done` - False if the operation is in progress, else true. * `metadata.@type` - the type of metadata. For example, the type string for CreateBackupMetadata is `type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata`. * `metadata.` - any field in metadata.value. `metadata.@type` must be specified first if filtering on metadata fields. * `error` - Error associated with the long-running operation. * `response.@type` - the type of response. * `response.` - any field in response.value. You can combine multiple expressions by enclosing each expression in parentheses. By default, expressions are combined with AND logic, but you can specify AND, OR, and NOT logic explicitly. Here are a few examples: * `done:true` - The operation is complete. * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \\ `metadata.database:prod` - Returns operations where: * The operation's metadata type is CreateBackupMetadata. * The source database name of backup contains the string \"prod\". * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \\ `(metadata.name:howl) AND` \\ `(metadata.progress.start_time \u003c \\\"2018-03-28T14:50:00Z\\\") AND` \\ `(error:*)` - Returns operations where: * The operation's metadata type is CreateBackupMetadata. * The backup name contains the string \"howl\". * The operation started before 2018-03-28T14:50:00Z. * The operation resulted in an error. * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CopyBackupMetadata) AND` \\ `(metadata.source_backup:test) AND` \\ `(metadata.progress.start_time \u003c \\\"2022-01-18T14:50:00Z\\\") AND` \\ `(error:*)` - Returns operations where: * The operation's metadata type is CopyBackupMetadata. * The source backup name contains the string \"test\". * The operation started before 2022-01-18T14:50:00Z. * The operation resulted in an error. * `((metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \\ `(metadata.database:test_db)) OR` \\ `((metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CopyBackupMetadata) AND` \\ `(metadata.source_backup:test_bkp)) AND` \\ `(error:*)` - Returns operations where: * The operation's metadata matches either of criteria: * The operation's metadata type is CreateBackupMetadata AND the source database name of the backup contains the string \"test_db\" * The operation's metadata type is CopyBackupMetadata AND the source backup name contains the string \"test_bkp\" * The operation resulted in an error.", "location": "query", "type": "string" }, @@ -2066,7 +2192,7 @@ } } }, - "revision": "20220326", + "revision": "20220404", "rootUrl": "https://spanner.googleapis.com/", "schemas": { "Backup": { @@ -2400,7 +2526,7 @@ "type": "object" }, "CopyBackupMetadata": { - "description": "Metadata type for the google.longrunning.Operation returned by CopyBackup.", + "description": "Metadata type for the operation returned by CopyBackup.", "id": "CopyBackupMetadata", "properties": { "cancelTime": { diff --git a/spanner/v1/spanner-gen.go b/spanner/v1/spanner-gen.go index 855ac4b2d7b..75977689805 100644 --- a/spanner/v1/spanner-gen.go +++ b/spanner/v1/spanner-gen.go @@ -171,11 +171,23 @@ type ProjectsService struct { func NewProjectsInstanceConfigsService(s *Service) *ProjectsInstanceConfigsService { rs := &ProjectsInstanceConfigsService{s: s} + rs.Operations = NewProjectsInstanceConfigsOperationsService(s) return rs } type ProjectsInstanceConfigsService struct { s *Service + + Operations *ProjectsInstanceConfigsOperationsService +} + +func NewProjectsInstanceConfigsOperationsService(s *Service) *ProjectsInstanceConfigsOperationsService { + rs := &ProjectsInstanceConfigsOperationsService{s: s} + return rs +} + +type ProjectsInstanceConfigsOperationsService struct { + s *Service } func NewProjectsInstancesService(s *Service) *ProjectsInstancesService { @@ -894,8 +906,8 @@ func (s *CopyBackupEncryptionConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// CopyBackupMetadata: Metadata type for the -// google.longrunning.Operation returned by CopyBackup. +// CopyBackupMetadata: Metadata type for the operation returned by +// CopyBackup. type CopyBackupMetadata struct { // CancelTime: The time at which cancellation of CopyBackup operation // was received. Operations.CancelOperation starts asynchronous @@ -5808,6 +5820,647 @@ func (c *ProjectsInstanceConfigsListCall) Pages(ctx context.Context, f func(*Lis } } +// method id "spanner.projects.instanceConfigs.operations.cancel": + +type ProjectsInstanceConfigsOperationsCancelCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Cancel: Starts asynchronous cancellation on a long-running operation. +// The server makes a best effort to cancel the operation, but success +// is not guaranteed. If the server doesn't support this method, it +// returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use +// Operations.GetOperation or other methods to check whether the +// cancellation succeeded or whether the operation completed despite +// cancellation. On successful cancellation, the operation is not +// deleted; instead, it becomes an operation with an Operation.error +// value with a google.rpc.Status.code of 1, corresponding to +// `Code.CANCELLED`. +// +// - name: The name of the operation resource to be cancelled. +func (r *ProjectsInstanceConfigsOperationsService) Cancel(name string) *ProjectsInstanceConfigsOperationsCancelCall { + c := &ProjectsInstanceConfigsOperationsCancelCall{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 *ProjectsInstanceConfigsOperationsCancelCall) Fields(s ...googleapi.Field) *ProjectsInstanceConfigsOperationsCancelCall { + 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 *ProjectsInstanceConfigsOperationsCancelCall) Context(ctx context.Context) *ProjectsInstanceConfigsOperationsCancelCall { + 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 *ProjectsInstanceConfigsOperationsCancelCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsInstanceConfigsOperationsCancelCall) 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, "v1/{+name}:cancel") + 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{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "spanner.projects.instanceConfigs.operations.cancel" call. +// Exactly one of *Empty or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Empty.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 *ProjectsInstanceConfigsOperationsCancelCall) Do(opts ...googleapi.CallOption) (*Empty, 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 := &Empty{ + 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": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + // "flatPath": "v1/projects/{projectsId}/instanceConfigs/{instanceConfigsId}/operations/{operationsId}:cancel", + // "httpMethod": "POST", + // "id": "spanner.projects.instanceConfigs.operations.cancel", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource to be cancelled.", + // "location": "path", + // "pattern": "^projects/[^/]+/instanceConfigs/[^/]+/operations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}:cancel", + // "response": { + // "$ref": "Empty" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/spanner.admin" + // ] + // } + +} + +// method id "spanner.projects.instanceConfigs.operations.delete": + +type ProjectsInstanceConfigsOperationsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a long-running operation. This method indicates that +// the client is no longer interested in the operation result. It does +// not cancel the operation. If the server doesn't support this method, +// it returns `google.rpc.Code.UNIMPLEMENTED`. +// +// - name: The name of the operation resource to be deleted. +func (r *ProjectsInstanceConfigsOperationsService) Delete(name string) *ProjectsInstanceConfigsOperationsDeleteCall { + c := &ProjectsInstanceConfigsOperationsDeleteCall{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 *ProjectsInstanceConfigsOperationsDeleteCall) Fields(s ...googleapi.Field) *ProjectsInstanceConfigsOperationsDeleteCall { + 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 *ProjectsInstanceConfigsOperationsDeleteCall) Context(ctx context.Context) *ProjectsInstanceConfigsOperationsDeleteCall { + 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 *ProjectsInstanceConfigsOperationsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsInstanceConfigsOperationsDeleteCall) 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, "v1/{+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 "spanner.projects.instanceConfigs.operations.delete" call. +// Exactly one of *Empty or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Empty.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 *ProjectsInstanceConfigsOperationsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, 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 := &Empty{ + 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 long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", + // "flatPath": "v1/projects/{projectsId}/instanceConfigs/{instanceConfigsId}/operations/{operationsId}", + // "httpMethod": "DELETE", + // "id": "spanner.projects.instanceConfigs.operations.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource to be deleted.", + // "location": "path", + // "pattern": "^projects/[^/]+/instanceConfigs/[^/]+/operations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Empty" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/spanner.admin" + // ] + // } + +} + +// method id "spanner.projects.instanceConfigs.operations.get": + +type ProjectsInstanceConfigsOperationsGetCall 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 *ProjectsInstanceConfigsOperationsService) Get(name string) *ProjectsInstanceConfigsOperationsGetCall { + c := &ProjectsInstanceConfigsOperationsGetCall{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 *ProjectsInstanceConfigsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsInstanceConfigsOperationsGetCall { + 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 *ProjectsInstanceConfigsOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsInstanceConfigsOperationsGetCall { + 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 *ProjectsInstanceConfigsOperationsGetCall) Context(ctx context.Context) *ProjectsInstanceConfigsOperationsGetCall { + 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 *ProjectsInstanceConfigsOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsInstanceConfigsOperationsGetCall) 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, "v1/{+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 "spanner.projects.instanceConfigs.operations.get" call. +// Exactly one of *Operation or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Operation.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 *ProjectsInstanceConfigsOperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, 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 := &Operation{ + 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": "v1/projects/{projectsId}/instanceConfigs/{instanceConfigsId}/operations/{operationsId}", + // "httpMethod": "GET", + // "id": "spanner.projects.instanceConfigs.operations.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource.", + // "location": "path", + // "pattern": "^projects/[^/]+/instanceConfigs/[^/]+/operations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Operation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/spanner.admin" + // ] + // } + +} + +// method id "spanner.projects.instanceConfigs.operations.list": + +type ProjectsInstanceConfigsOperationsListCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists operations that match the specified filter in the +// request. If the server doesn't support this method, it returns +// `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to +// override the binding to use different resource name schemes, such as +// `users/*/operations`. To override the binding, API services can add a +// binding such as "/v1/{name=users/*}/operations" to their service +// configuration. For backwards compatibility, the default name includes +// the operations collection id, however overriding users must ensure +// the name binding is the parent resource, without the operations +// collection id. +// +// - name: The name of the operation's parent resource. +func (r *ProjectsInstanceConfigsOperationsService) List(name string) *ProjectsInstanceConfigsOperationsListCall { + c := &ProjectsInstanceConfigsOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list +// filter. +func (c *ProjectsInstanceConfigsOperationsListCall) Filter(filter string) *ProjectsInstanceConfigsOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list +// page size. +func (c *ProjectsInstanceConfigsOperationsListCall) PageSize(pageSize int64) *ProjectsInstanceConfigsOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list +// page token. +func (c *ProjectsInstanceConfigsOperationsListCall) PageToken(pageToken string) *ProjectsInstanceConfigsOperationsListCall { + 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 *ProjectsInstanceConfigsOperationsListCall) Fields(s ...googleapi.Field) *ProjectsInstanceConfigsOperationsListCall { + 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 *ProjectsInstanceConfigsOperationsListCall) IfNoneMatch(entityTag string) *ProjectsInstanceConfigsOperationsListCall { + 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 *ProjectsInstanceConfigsOperationsListCall) Context(ctx context.Context) *ProjectsInstanceConfigsOperationsListCall { + 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 *ProjectsInstanceConfigsOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsInstanceConfigsOperationsListCall) 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, "v1/{+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 "spanner.projects.instanceConfigs.operations.list" call. +// Exactly one of *ListOperationsResponse or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *ListOperationsResponse.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 *ProjectsInstanceConfigsOperationsListCall) Do(opts ...googleapi.CallOption) (*ListOperationsResponse, 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 := &ListOperationsResponse{ + 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 operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to override the binding to use different resource name schemes, such as `users/*/operations`. To override the binding, API services can add a binding such as `\"/v1/{name=users/*}/operations\"` to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id.", + // "flatPath": "v1/projects/{projectsId}/instanceConfigs/{instanceConfigsId}/operations", + // "httpMethod": "GET", + // "id": "spanner.projects.instanceConfigs.operations.list", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "filter": { + // "description": "The standard list filter.", + // "location": "query", + // "type": "string" + // }, + // "name": { + // "description": "The name of the operation's parent resource.", + // "location": "path", + // "pattern": "^projects/[^/]+/instanceConfigs/[^/]+/operations$", + // "required": true, + // "type": "string" + // }, + // "pageSize": { + // "description": "The standard list page size.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The standard list page token.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "ListOperationsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/spanner.admin" + // ] + // } + +} + +// 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 *ProjectsInstanceConfigsOperationsListCall) Pages(ctx context.Context, f func(*ListOperationsResponse) 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 "spanner.projects.instances.create": type ProjectsInstancesCreateCall struct { @@ -7170,8 +7823,8 @@ func (r *ProjectsInstancesBackupOperationsService) List(parent string) *Projects // `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1. // CreateBackupMetadata) AND` \ `metadata.database:prod` - Returns // operations where: * The operation's metadata type is -// CreateBackupMetadata. * The database the backup was taken from has a -// name containing the string "prod". * +// CreateBackupMetadata. * The source database name of backup contains +// the string "prod". * // `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1. // CreateBackupMetadata) AND` \ `(metadata.name:howl) AND` \ // `(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND` \ @@ -7183,19 +7836,19 @@ func (r *ProjectsInstancesBackupOperationsService) List(parent string) *Projects // CopyBackupMetadata) AND` \ `(metadata.source_backup:test) AND` \ // `(metadata.progress.start_time < \"2022-01-18T14:50:00Z\") AND` \ // `(error:*)` - Returns operations where: * The operation's metadata -// type is CopyBackupMetadata. * The source backup of the copied backup -// name contains the string "test". * The operation started before -// 2022-01-18T14:50:00Z. * The operation resulted in an error. * +// type is CopyBackupMetadata. * The source backup name contains the +// string "test". * The operation started before 2022-01-18T14:50:00Z. * +// The operation resulted in an error. * // `((metadata.@type=type.googleapis.com/google.spanner.admin.database.v1 // .CreateBackupMetadata) AND` \ `(metadata.database:test_db)) OR` \ // `((metadata.@type=type.googleapis.com/google.spanner.admin.database.v1 // .CopyBackupMetadata) AND` \ `(metadata.source_backup:test_bkp)) AND` // \ `(error:*)` - Returns operations where: * The operation's metadata // matches either of criteria: * The operation's metadata type is -// CreateBackupMetadata AND the database the backup was taken from has -// name containing string "test_db" * The operation's metadata type is -// CopyBackupMetadata AND the backup the backup was copied from has name -// containing string "test_bkp" * The operation resulted in an error. +// CreateBackupMetadata AND the source database name of the backup +// contains the string "test_db" * The operation's metadata type is +// CopyBackupMetadata AND the source backup name contains the string +// "test_bkp" * The operation resulted in an error. func (c *ProjectsInstancesBackupOperationsListCall) Filter(filter string) *ProjectsInstancesBackupOperationsListCall { c.urlParams_.Set("filter", filter) return c @@ -7326,7 +7979,7 @@ func (c *ProjectsInstancesBackupOperationsListCall) Do(opts ...googleapi.CallOpt // ], // "parameters": { // "filter": { - // "description": "An expression that filters the list of returned backup operations. A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string, a number, or a boolean. The comparison operator must be one of: `\u003c`, `\u003e`, `\u003c=`, `\u003e=`, `!=`, `=`, or `:`. Colon `:` is the contains operator. Filter rules are not case sensitive. The following fields in the operation are eligible for filtering: * `name` - The name of the long-running operation * `done` - False if the operation is in progress, else true. * `metadata.@type` - the type of metadata. For example, the type string for CreateBackupMetadata is `type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata`. * `metadata.` - any field in metadata.value. `metadata.@type` must be specified first if filtering on metadata fields. * `error` - Error associated with the long-running operation. * `response.@type` - the type of response. * `response.` - any field in response.value. You can combine multiple expressions by enclosing each expression in parentheses. By default, expressions are combined with AND logic, but you can specify AND, OR, and NOT logic explicitly. Here are a few examples: * `done:true` - The operation is complete. * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \\ `metadata.database:prod` - Returns operations where: * The operation's metadata type is CreateBackupMetadata. * The database the backup was taken from has a name containing the string \"prod\". * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \\ `(metadata.name:howl) AND` \\ `(metadata.progress.start_time \u003c \\\"2018-03-28T14:50:00Z\\\") AND` \\ `(error:*)` - Returns operations where: * The operation's metadata type is CreateBackupMetadata. * The backup name contains the string \"howl\". * The operation started before 2018-03-28T14:50:00Z. * The operation resulted in an error. * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CopyBackupMetadata) AND` \\ `(metadata.source_backup:test) AND` \\ `(metadata.progress.start_time \u003c \\\"2022-01-18T14:50:00Z\\\") AND` \\ `(error:*)` - Returns operations where: * The operation's metadata type is CopyBackupMetadata. * The source backup of the copied backup name contains the string \"test\". * The operation started before 2022-01-18T14:50:00Z. * The operation resulted in an error. * `((metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \\ `(metadata.database:test_db)) OR` \\ `((metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CopyBackupMetadata) AND` \\ `(metadata.source_backup:test_bkp)) AND` \\ `(error:*)` - Returns operations where: * The operation's metadata matches either of criteria: * The operation's metadata type is CreateBackupMetadata AND the database the backup was taken from has name containing string \"test_db\" * The operation's metadata type is CopyBackupMetadata AND the backup the backup was copied from has name containing string \"test_bkp\" * The operation resulted in an error.", + // "description": "An expression that filters the list of returned backup operations. A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string, a number, or a boolean. The comparison operator must be one of: `\u003c`, `\u003e`, `\u003c=`, `\u003e=`, `!=`, `=`, or `:`. Colon `:` is the contains operator. Filter rules are not case sensitive. The following fields in the operation are eligible for filtering: * `name` - The name of the long-running operation * `done` - False if the operation is in progress, else true. * `metadata.@type` - the type of metadata. For example, the type string for CreateBackupMetadata is `type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata`. * `metadata.` - any field in metadata.value. `metadata.@type` must be specified first if filtering on metadata fields. * `error` - Error associated with the long-running operation. * `response.@type` - the type of response. * `response.` - any field in response.value. You can combine multiple expressions by enclosing each expression in parentheses. By default, expressions are combined with AND logic, but you can specify AND, OR, and NOT logic explicitly. Here are a few examples: * `done:true` - The operation is complete. * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \\ `metadata.database:prod` - Returns operations where: * The operation's metadata type is CreateBackupMetadata. * The source database name of backup contains the string \"prod\". * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \\ `(metadata.name:howl) AND` \\ `(metadata.progress.start_time \u003c \\\"2018-03-28T14:50:00Z\\\") AND` \\ `(error:*)` - Returns operations where: * The operation's metadata type is CreateBackupMetadata. * The backup name contains the string \"howl\". * The operation started before 2018-03-28T14:50:00Z. * The operation resulted in an error. * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CopyBackupMetadata) AND` \\ `(metadata.source_backup:test) AND` \\ `(metadata.progress.start_time \u003c \\\"2022-01-18T14:50:00Z\\\") AND` \\ `(error:*)` - Returns operations where: * The operation's metadata type is CopyBackupMetadata. * The source backup name contains the string \"test\". * The operation started before 2022-01-18T14:50:00Z. * The operation resulted in an error. * `((metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \\ `(metadata.database:test_db)) OR` \\ `((metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CopyBackupMetadata) AND` \\ `(metadata.source_backup:test_bkp)) AND` \\ `(error:*)` - Returns operations where: * The operation's metadata matches either of criteria: * The operation's metadata type is CreateBackupMetadata AND the source database name of the backup contains the string \"test_db\" * The operation's metadata type is CopyBackupMetadata AND the source backup name contains the string \"test_bkp\" * The operation resulted in an error.", // "location": "query", // "type": "string" // }, diff --git a/storage/v1/storage-api.json b/storage/v1/storage-api.json index 80345543880..998eac671dd 100644 --- a/storage/v1/storage-api.json +++ b/storage/v1/storage-api.json @@ -26,7 +26,7 @@ "description": "Stores and retrieves potentially large, immutable data objects.", "discoveryVersion": "v1", "documentationLink": "https://developers.google.com/storage/docs/json_api/", - "etag": "\"3133303835363638353739313239313939393935\"", + "etag": "\"37343432393730373535343630303638323335\"", "icons": { "x16": "https://www.google.com/images/icons/product/cloud_storage-16.png", "x32": "https://www.google.com/images/icons/product/cloud_storage-32.png" @@ -115,11 +115,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -153,11 +148,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -187,11 +177,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -224,11 +209,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -265,11 +245,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -309,11 +284,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -362,11 +332,6 @@ "location": "query", "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -419,11 +384,6 @@ "location": "query", "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -463,11 +423,6 @@ "minimum": "1", "type": "integer" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -550,11 +505,6 @@ "location": "query", "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request.", "location": "query", @@ -619,11 +569,6 @@ "location": "query", "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request.", "location": "query", @@ -664,11 +609,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -764,11 +704,6 @@ "location": "query", "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -801,11 +736,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -846,11 +776,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -948,11 +873,6 @@ "location": "query", "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -1017,11 +937,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -1055,11 +970,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -1089,11 +999,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -1138,11 +1043,6 @@ "location": "query", "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -1179,11 +1079,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -1223,11 +1118,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -1271,11 +1161,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -1310,11 +1195,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -1347,11 +1227,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -1385,11 +1260,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -1446,11 +1316,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -1497,11 +1362,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -1544,11 +1404,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -1594,11 +1449,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -1648,11 +1498,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -1705,11 +1550,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -1791,11 +1631,6 @@ "location": "query", "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -1925,11 +1760,6 @@ "location": "query", "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "sourceBucket": { "description": "Name of the bucket in which to find the source object.", "location": "path", @@ -2018,11 +1848,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -2100,11 +1925,6 @@ "location": "query", "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -2152,11 +1972,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -2277,11 +2092,6 @@ "location": "query", "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -2362,11 +2172,6 @@ "location": "query", "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "startOffset": { "description": "Filter results to objects whose names are lexicographically equal to or after startOffset. If endOffset is also set, the objects listed will have names between startOffset (inclusive) and endOffset (exclusive).", "location": "query", @@ -2481,11 +2286,6 @@ "location": "query", "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request, for Requester Pays buckets.", "location": "query", @@ -2620,11 +2420,6 @@ "location": "query", "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "rewriteToken": { "description": "Include this field (from the previous rewrite response) on each rewrite request after the first one, until the rewrite response 'done' flag is true. Calls that provide a rewriteToken can omit all other request fields, but if included those fields must match the values provided in the first rewrite request.", "location": "query", @@ -2694,11 +2489,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -2753,11 +2543,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -2861,11 +2646,6 @@ "location": "query", "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request. Required for Requester Pays buckets.", "location": "query", @@ -2944,11 +2724,6 @@ "location": "query", "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "startOffset": { "description": "Filter results to objects whose names are lexicographically equal to or after startOffset. If endOffset is also set, the objects listed will have names between startOffset (inclusive) and endOffset (exclusive).", "location": "query", @@ -3207,11 +2982,6 @@ "required": true, "type": "string" }, - "provisionalUserProject": { - "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - "location": "query", - "type": "string" - }, "userProject": { "description": "The project to be billed for this request.", "location": "query", @@ -3235,7 +3005,7 @@ } } }, - "revision": "20220328", + "revision": "20220401", "rootUrl": "https://storage.googleapis.com/", "schemas": { "Bucket": { diff --git a/storage/v1/storage-gen.go b/storage/v1/storage-gen.go index f1470a3a585..a5bb739f9e7 100644 --- a/storage/v1/storage-gen.go +++ b/storage/v1/storage-gen.go @@ -2446,14 +2446,6 @@ func (r *BucketAccessControlsService) Delete(bucket string, entity string) *Buck return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *BucketAccessControlsDeleteCall) ProvisionalUserProject(provisionalUserProject string) *BucketAccessControlsDeleteCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *BucketAccessControlsDeleteCall) UserProject(userProject string) *BucketAccessControlsDeleteCall { @@ -2543,11 +2535,6 @@ func (c *BucketAccessControlsDeleteCall) Do(opts ...googleapi.CallOption) error // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -2589,14 +2576,6 @@ func (r *BucketAccessControlsService) Get(bucket string, entity string) *BucketA return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *BucketAccessControlsGetCall) ProvisionalUserProject(provisionalUserProject string) *BucketAccessControlsGetCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *BucketAccessControlsGetCall) UserProject(userProject string) *BucketAccessControlsGetCall { @@ -2724,11 +2703,6 @@ func (c *BucketAccessControlsGetCall) Do(opts ...googleapi.CallOption) (*BucketA // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -2768,14 +2742,6 @@ func (r *BucketAccessControlsService) Insert(bucket string, bucketaccesscontrol return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *BucketAccessControlsInsertCall) ProvisionalUserProject(provisionalUserProject string) *BucketAccessControlsInsertCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *BucketAccessControlsInsertCall) UserProject(userProject string) *BucketAccessControlsInsertCall { @@ -2887,11 +2853,6 @@ func (c *BucketAccessControlsInsertCall) Do(opts ...googleapi.CallOption) (*Buck // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -2933,14 +2894,6 @@ func (r *BucketAccessControlsService) List(bucket string) *BucketAccessControlsL return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *BucketAccessControlsListCall) ProvisionalUserProject(provisionalUserProject string) *BucketAccessControlsListCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *BucketAccessControlsListCall) UserProject(userProject string) *BucketAccessControlsListCall { @@ -3060,11 +3013,6 @@ func (c *BucketAccessControlsListCall) Do(opts ...googleapi.CallOption) (*Bucket // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -3109,14 +3057,6 @@ func (r *BucketAccessControlsService) Patch(bucket string, entity string, bucket return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *BucketAccessControlsPatchCall) ProvisionalUserProject(provisionalUserProject string) *BucketAccessControlsPatchCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *BucketAccessControlsPatchCall) UserProject(userProject string) *BucketAccessControlsPatchCall { @@ -3236,11 +3176,6 @@ func (c *BucketAccessControlsPatchCall) Do(opts ...googleapi.CallOption) (*Bucke // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -3288,14 +3223,6 @@ func (r *BucketAccessControlsService) Update(bucket string, entity string, bucke return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *BucketAccessControlsUpdateCall) ProvisionalUserProject(provisionalUserProject string) *BucketAccessControlsUpdateCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *BucketAccessControlsUpdateCall) UserProject(userProject string) *BucketAccessControlsUpdateCall { @@ -3415,11 +3342,6 @@ func (c *BucketAccessControlsUpdateCall) Do(opts ...googleapi.CallOption) (*Buck // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -3476,14 +3398,6 @@ func (c *BucketsDeleteCall) IfMetagenerationNotMatch(ifMetagenerationNotMatch in return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *BucketsDeleteCall) ProvisionalUserProject(provisionalUserProject string) *BucketsDeleteCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *BucketsDeleteCall) UserProject(userProject string) *BucketsDeleteCall { @@ -3577,11 +3491,6 @@ func (c *BucketsDeleteCall) Do(opts ...googleapi.CallOption) error { // "location": "query", // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -3647,14 +3556,6 @@ func (c *BucketsGetCall) Projection(projection string) *BucketsGetCall { return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *BucketsGetCall) ProvisionalUserProject(provisionalUserProject string) *BucketsGetCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *BucketsGetCall) UserProject(userProject string) *BucketsGetCall { @@ -3799,11 +3700,6 @@ func (c *BucketsGetCall) Do(opts ...googleapi.CallOption) (*Bucket, error) { // "location": "query", // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -3855,14 +3751,6 @@ func (c *BucketsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequested return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *BucketsGetIamPolicyCall) ProvisionalUserProject(provisionalUserProject string) *BucketsGetIamPolicyCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *BucketsGetIamPolicyCall) UserProject(userProject string) *BucketsGetIamPolicyCall { @@ -3989,11 +3877,6 @@ func (c *BucketsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, err // "minimum": "1", // "type": "integer" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -4084,14 +3967,6 @@ func (c *BucketsInsertCall) Projection(projection string) *BucketsInsertCall { return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *BucketsInsertCall) ProvisionalUserProject(provisionalUserProject string) *BucketsInsertCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. func (c *BucketsInsertCall) UserProject(userProject string) *BucketsInsertCall { @@ -4253,11 +4128,6 @@ func (c *BucketsInsertCall) Do(opts ...googleapi.CallOption) (*Bucket, error) { // "location": "query", // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request.", // "location": "query", @@ -4333,14 +4203,6 @@ func (c *BucketsListCall) Projection(projection string) *BucketsListCall { return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *BucketsListCall) ProvisionalUserProject(provisionalUserProject string) *BucketsListCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. func (c *BucketsListCall) UserProject(userProject string) *BucketsListCall { @@ -4488,11 +4350,6 @@ func (c *BucketsListCall) Do(opts ...googleapi.CallOption) (*Buckets, error) { // "location": "query", // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request.", // "location": "query", @@ -4557,14 +4414,6 @@ func (r *BucketsService) LockRetentionPolicy(bucket string, ifMetagenerationMatc return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *BucketsLockRetentionPolicyCall) ProvisionalUserProject(provisionalUserProject string) *BucketsLockRetentionPolicyCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *BucketsLockRetentionPolicyCall) UserProject(userProject string) *BucketsLockRetentionPolicyCall { @@ -4679,11 +4528,6 @@ func (c *BucketsLockRetentionPolicyCall) Do(opts ...googleapi.CallOption) (*Buck // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -4794,14 +4638,6 @@ func (c *BucketsPatchCall) Projection(projection string) *BucketsPatchCall { return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *BucketsPatchCall) ProvisionalUserProject(provisionalUserProject string) *BucketsPatchCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *BucketsPatchCall) UserProject(userProject string) *BucketsPatchCall { @@ -4978,11 +4814,6 @@ func (c *BucketsPatchCall) Do(opts ...googleapi.CallOption) (*Bucket, error) { // "location": "query", // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -5025,14 +4856,6 @@ func (r *BucketsService) SetIamPolicy(bucket string, policy *Policy) *BucketsSet return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *BucketsSetIamPolicyCall) ProvisionalUserProject(provisionalUserProject string) *BucketsSetIamPolicyCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *BucketsSetIamPolicyCall) UserProject(userProject string) *BucketsSetIamPolicyCall { @@ -5144,11 +4967,6 @@ func (c *BucketsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, err // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -5193,14 +5011,6 @@ func (r *BucketsService) TestIamPermissions(bucket string, permissions []string) return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *BucketsTestIamPermissionsCall) ProvisionalUserProject(provisionalUserProject string) *BucketsTestIamPermissionsCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *BucketsTestIamPermissionsCall) UserProject(userProject string) *BucketsTestIamPermissionsCall { @@ -5328,11 +5138,6 @@ func (c *BucketsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestI // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -5445,14 +5250,6 @@ func (c *BucketsUpdateCall) Projection(projection string) *BucketsUpdateCall { return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *BucketsUpdateCall) ProvisionalUserProject(provisionalUserProject string) *BucketsUpdateCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *BucketsUpdateCall) UserProject(userProject string) *BucketsUpdateCall { @@ -5629,11 +5426,6 @@ func (c *BucketsUpdateCall) Do(opts ...googleapi.CallOption) (*Bucket, error) { // "location": "query", // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -5779,14 +5571,6 @@ func (r *DefaultObjectAccessControlsService) Delete(bucket string, entity string return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *DefaultObjectAccessControlsDeleteCall) ProvisionalUserProject(provisionalUserProject string) *DefaultObjectAccessControlsDeleteCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *DefaultObjectAccessControlsDeleteCall) UserProject(userProject string) *DefaultObjectAccessControlsDeleteCall { @@ -5876,11 +5660,6 @@ func (c *DefaultObjectAccessControlsDeleteCall) Do(opts ...googleapi.CallOption) // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -5922,14 +5701,6 @@ func (r *DefaultObjectAccessControlsService) Get(bucket string, entity string) * return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *DefaultObjectAccessControlsGetCall) ProvisionalUserProject(provisionalUserProject string) *DefaultObjectAccessControlsGetCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *DefaultObjectAccessControlsGetCall) UserProject(userProject string) *DefaultObjectAccessControlsGetCall { @@ -6057,11 +5828,6 @@ func (c *DefaultObjectAccessControlsGetCall) Do(opts ...googleapi.CallOption) (* // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -6102,14 +5868,6 @@ func (r *DefaultObjectAccessControlsService) Insert(bucket string, objectaccessc return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *DefaultObjectAccessControlsInsertCall) ProvisionalUserProject(provisionalUserProject string) *DefaultObjectAccessControlsInsertCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *DefaultObjectAccessControlsInsertCall) UserProject(userProject string) *DefaultObjectAccessControlsInsertCall { @@ -6221,11 +5979,6 @@ func (c *DefaultObjectAccessControlsInsertCall) Do(opts ...googleapi.CallOption) // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -6284,14 +6037,6 @@ func (c *DefaultObjectAccessControlsListCall) IfMetagenerationNotMatch(ifMetagen return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *DefaultObjectAccessControlsListCall) ProvisionalUserProject(provisionalUserProject string) *DefaultObjectAccessControlsListCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *DefaultObjectAccessControlsListCall) UserProject(userProject string) *DefaultObjectAccessControlsListCall { @@ -6423,11 +6168,6 @@ func (c *DefaultObjectAccessControlsListCall) Do(opts ...googleapi.CallOption) ( // "location": "query", // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -6472,14 +6212,6 @@ func (r *DefaultObjectAccessControlsService) Patch(bucket string, entity string, return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *DefaultObjectAccessControlsPatchCall) ProvisionalUserProject(provisionalUserProject string) *DefaultObjectAccessControlsPatchCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *DefaultObjectAccessControlsPatchCall) UserProject(userProject string) *DefaultObjectAccessControlsPatchCall { @@ -6599,11 +6331,6 @@ func (c *DefaultObjectAccessControlsPatchCall) Do(opts ...googleapi.CallOption) // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -6651,14 +6378,6 @@ func (r *DefaultObjectAccessControlsService) Update(bucket string, entity string return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *DefaultObjectAccessControlsUpdateCall) ProvisionalUserProject(provisionalUserProject string) *DefaultObjectAccessControlsUpdateCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *DefaultObjectAccessControlsUpdateCall) UserProject(userProject string) *DefaultObjectAccessControlsUpdateCall { @@ -6778,11 +6497,6 @@ func (c *DefaultObjectAccessControlsUpdateCall) Do(opts ...googleapi.CallOption) // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -6826,14 +6540,6 @@ func (r *NotificationsService) Delete(bucket string, notification string) *Notif return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *NotificationsDeleteCall) ProvisionalUserProject(provisionalUserProject string) *NotificationsDeleteCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *NotificationsDeleteCall) UserProject(userProject string) *NotificationsDeleteCall { @@ -6923,11 +6629,6 @@ func (c *NotificationsDeleteCall) Do(opts ...googleapi.CallOption) error { // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -6967,14 +6668,6 @@ func (r *NotificationsService) Get(bucket string, notification string) *Notifica return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *NotificationsGetCall) ProvisionalUserProject(provisionalUserProject string) *NotificationsGetCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *NotificationsGetCall) UserProject(userProject string) *NotificationsGetCall { @@ -7102,11 +6795,6 @@ func (c *NotificationsGetCall) Do(opts ...googleapi.CallOption) (*Notification, // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -7149,14 +6837,6 @@ func (r *NotificationsService) Insert(bucket string, notification *Notification) return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *NotificationsInsertCall) ProvisionalUserProject(provisionalUserProject string) *NotificationsInsertCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *NotificationsInsertCall) UserProject(userProject string) *NotificationsInsertCall { @@ -7268,11 +6948,6 @@ func (c *NotificationsInsertCall) Do(opts ...googleapi.CallOption) (*Notificatio // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -7316,14 +6991,6 @@ func (r *NotificationsService) List(bucket string) *NotificationsListCall { return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *NotificationsListCall) ProvisionalUserProject(provisionalUserProject string) *NotificationsListCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *NotificationsListCall) UserProject(userProject string) *NotificationsListCall { @@ -7443,11 +7110,6 @@ func (c *NotificationsListCall) Do(opts ...googleapi.CallOption) (*Notifications // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -7506,14 +7168,6 @@ func (c *ObjectAccessControlsDeleteCall) Generation(generation int64) *ObjectAcc return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *ObjectAccessControlsDeleteCall) ProvisionalUserProject(provisionalUserProject string) *ObjectAccessControlsDeleteCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *ObjectAccessControlsDeleteCall) UserProject(userProject string) *ObjectAccessControlsDeleteCall { @@ -7617,11 +7271,6 @@ func (c *ObjectAccessControlsDeleteCall) Do(opts ...googleapi.CallOption) error // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -7675,14 +7324,6 @@ func (c *ObjectAccessControlsGetCall) Generation(generation int64) *ObjectAccess return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *ObjectAccessControlsGetCall) ProvisionalUserProject(provisionalUserProject string) *ObjectAccessControlsGetCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *ObjectAccessControlsGetCall) UserProject(userProject string) *ObjectAccessControlsGetCall { @@ -7824,11 +7465,6 @@ func (c *ObjectAccessControlsGetCall) Do(opts ...googleapi.CallOption) (*ObjectA // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -7880,14 +7516,6 @@ func (c *ObjectAccessControlsInsertCall) Generation(generation int64) *ObjectAcc return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *ObjectAccessControlsInsertCall) ProvisionalUserProject(provisionalUserProject string) *ObjectAccessControlsInsertCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *ObjectAccessControlsInsertCall) UserProject(userProject string) *ObjectAccessControlsInsertCall { @@ -8013,11 +7641,6 @@ func (c *ObjectAccessControlsInsertCall) Do(opts ...googleapi.CallOption) (*Obje // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -8071,14 +7694,6 @@ func (c *ObjectAccessControlsListCall) Generation(generation int64) *ObjectAcces return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *ObjectAccessControlsListCall) ProvisionalUserProject(provisionalUserProject string) *ObjectAccessControlsListCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *ObjectAccessControlsListCall) UserProject(userProject string) *ObjectAccessControlsListCall { @@ -8212,11 +7827,6 @@ func (c *ObjectAccessControlsListCall) Do(opts ...googleapi.CallOption) (*Object // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -8273,14 +7883,6 @@ func (c *ObjectAccessControlsPatchCall) Generation(generation int64) *ObjectAcce return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *ObjectAccessControlsPatchCall) ProvisionalUserProject(provisionalUserProject string) *ObjectAccessControlsPatchCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *ObjectAccessControlsPatchCall) UserProject(userProject string) *ObjectAccessControlsPatchCall { @@ -8414,11 +8016,6 @@ func (c *ObjectAccessControlsPatchCall) Do(opts ...googleapi.CallOption) (*Objec // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -8478,14 +8075,6 @@ func (c *ObjectAccessControlsUpdateCall) Generation(generation int64) *ObjectAcc return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *ObjectAccessControlsUpdateCall) ProvisionalUserProject(provisionalUserProject string) *ObjectAccessControlsUpdateCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *ObjectAccessControlsUpdateCall) UserProject(userProject string) *ObjectAccessControlsUpdateCall { @@ -8619,11 +8208,6 @@ func (c *ObjectAccessControlsUpdateCall) Do(opts ...googleapi.CallOption) (*Obje // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -8721,14 +8305,6 @@ func (c *ObjectsComposeCall) KmsKeyName(kmsKeyName string) *ObjectsComposeCall { return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *ObjectsComposeCall) ProvisionalUserProject(provisionalUserProject string) *ObjectsComposeCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *ObjectsComposeCall) UserProject(userProject string) *ObjectsComposeCall { @@ -8886,11 +8462,6 @@ func (c *ObjectsComposeCall) Do(opts ...googleapi.CallOption) (*Object, error) { // "location": "query", // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -9069,14 +8640,6 @@ func (c *ObjectsCopyCall) Projection(projection string) *ObjectsCopyCall { return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *ObjectsCopyCall) ProvisionalUserProject(provisionalUserProject string) *ObjectsCopyCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // SourceGeneration sets the optional parameter "sourceGeneration": If // present, selects a specific revision of the source object (as opposed // to the latest version, the default). @@ -9295,11 +8858,6 @@ func (c *ObjectsCopyCall) Do(opts ...googleapi.CallOption) (*Object, error) { // "location": "query", // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "sourceBucket": { // "description": "Name of the bucket in which to find the source object.", // "location": "path", @@ -9409,14 +8967,6 @@ func (c *ObjectsDeleteCall) IfMetagenerationNotMatch(ifMetagenerationNotMatch in return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *ObjectsDeleteCall) ProvisionalUserProject(provisionalUserProject string) *ObjectsDeleteCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *ObjectsDeleteCall) UserProject(userProject string) *ObjectsDeleteCall { @@ -9536,11 +9086,6 @@ func (c *ObjectsDeleteCall) Do(opts ...googleapi.CallOption) error { // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -9636,14 +9181,6 @@ func (c *ObjectsGetCall) Projection(projection string) *ObjectsGetCall { return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *ObjectsGetCall) ProvisionalUserProject(provisionalUserProject string) *ObjectsGetCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *ObjectsGetCall) UserProject(userProject string) *ObjectsGetCall { @@ -9830,11 +9367,6 @@ func (c *ObjectsGetCall) Do(opts ...googleapi.CallOption) (*Object, error) { // "location": "query", // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -9890,14 +9422,6 @@ func (c *ObjectsGetIamPolicyCall) Generation(generation int64) *ObjectsGetIamPol return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *ObjectsGetIamPolicyCall) ProvisionalUserProject(provisionalUserProject string) *ObjectsGetIamPolicyCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *ObjectsGetIamPolicyCall) UserProject(userProject string) *ObjectsGetIamPolicyCall { @@ -10031,11 +9555,6 @@ func (c *ObjectsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, err // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -10179,14 +9698,6 @@ func (c *ObjectsInsertCall) Projection(projection string) *ObjectsInsertCall { return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *ObjectsInsertCall) ProvisionalUserProject(provisionalUserProject string) *ObjectsInsertCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *ObjectsInsertCall) UserProject(userProject string) *ObjectsInsertCall { @@ -10486,11 +9997,6 @@ func (c *ObjectsInsertCall) Do(opts ...googleapi.CallOption) (*Object, error) { // "location": "query", // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -10599,14 +10105,6 @@ func (c *ObjectsListCall) Projection(projection string) *ObjectsListCall { return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *ObjectsListCall) ProvisionalUserProject(provisionalUserProject string) *ObjectsListCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // StartOffset sets the optional parameter "startOffset": Filter results // to objects whose names are lexicographically equal to or after // startOffset. If endOffset is also set, the objects listed will have @@ -10789,11 +10287,6 @@ func (c *ObjectsListCall) Do(opts ...googleapi.CallOption) (*Objects, error) { // "location": "query", // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "startOffset": { // "description": "Filter results to objects whose names are lexicographically equal to or after startOffset. If endOffset is also set, the objects listed will have names between startOffset (inclusive) and endOffset (exclusive).", // "location": "query", @@ -10947,14 +10440,6 @@ func (c *ObjectsPatchCall) Projection(projection string) *ObjectsPatchCall { return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *ObjectsPatchCall) ProvisionalUserProject(provisionalUserProject string) *ObjectsPatchCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request, for Requester Pays buckets. func (c *ObjectsPatchCall) UserProject(userProject string) *ObjectsPatchCall { @@ -11138,11 +10623,6 @@ func (c *ObjectsPatchCall) Do(opts ...googleapi.CallOption) (*Object, error) { // "location": "query", // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request, for Requester Pays buckets.", // "location": "query", @@ -11333,14 +10813,6 @@ func (c *ObjectsRewriteCall) Projection(projection string) *ObjectsRewriteCall { return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *ObjectsRewriteCall) ProvisionalUserProject(provisionalUserProject string) *ObjectsRewriteCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // RewriteToken sets the optional parameter "rewriteToken": Include this // field (from the previous rewrite response) on each rewrite request // after the first one, until the rewrite response 'done' flag is true. @@ -11576,11 +11048,6 @@ func (c *ObjectsRewriteCall) Do(opts ...googleapi.CallOption) (*RewriteResponse, // "location": "query", // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "rewriteToken": { // "description": "Include this field (from the previous rewrite response) on each rewrite request after the first one, until the rewrite response 'done' flag is true. Calls that provide a rewriteToken can omit all other request fields, but if included those fields must match the values provided in the first rewrite request.", // "location": "query", @@ -11659,14 +11126,6 @@ func (c *ObjectsSetIamPolicyCall) Generation(generation int64) *ObjectsSetIamPol return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *ObjectsSetIamPolicyCall) ProvisionalUserProject(provisionalUserProject string) *ObjectsSetIamPolicyCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *ObjectsSetIamPolicyCall) UserProject(userProject string) *ObjectsSetIamPolicyCall { @@ -11792,11 +11251,6 @@ func (c *ObjectsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, err // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -11854,14 +11308,6 @@ func (c *ObjectsTestIamPermissionsCall) Generation(generation int64) *ObjectsTes return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *ObjectsTestIamPermissionsCall) ProvisionalUserProject(provisionalUserProject string) *ObjectsTestIamPermissionsCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *ObjectsTestIamPermissionsCall) UserProject(userProject string) *ObjectsTestIamPermissionsCall { @@ -12003,11 +11449,6 @@ func (c *ObjectsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestI // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -12129,14 +11570,6 @@ func (c *ObjectsUpdateCall) Projection(projection string) *ObjectsUpdateCall { return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *ObjectsUpdateCall) ProvisionalUserProject(provisionalUserProject string) *ObjectsUpdateCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. Required for Requester Pays buckets. func (c *ObjectsUpdateCall) UserProject(userProject string) *ObjectsUpdateCall { @@ -12320,11 +11753,6 @@ func (c *ObjectsUpdateCall) Do(opts ...googleapi.CallOption) (*Object, error) { // "location": "query", // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request. Required for Requester Pays buckets.", // "location": "query", @@ -12432,14 +11860,6 @@ func (c *ObjectsWatchAllCall) Projection(projection string) *ObjectsWatchAllCall return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *ObjectsWatchAllCall) ProvisionalUserProject(provisionalUserProject string) *ObjectsWatchAllCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // StartOffset sets the optional parameter "startOffset": Filter results // to objects whose names are lexicographically equal to or after // startOffset. If endOffset is also set, the objects listed will have @@ -12614,11 +12034,6 @@ func (c *ObjectsWatchAllCall) Do(opts ...googleapi.CallOption) (*Channel, error) // "location": "query", // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "startOffset": { // "description": "Filter results to objects whose names are lexicographically equal to or after startOffset. If endOffset is also set, the objects listed will have names between startOffset (inclusive) and endOffset (exclusive).", // "location": "query", @@ -13530,14 +12945,6 @@ func (r *ProjectsServiceAccountService) Get(projectId string) *ProjectsServiceAc return c } -// ProvisionalUserProject sets the optional parameter -// "provisionalUserProject": The project to be billed for this request -// if the target bucket is requester-pays bucket. -func (c *ProjectsServiceAccountGetCall) ProvisionalUserProject(provisionalUserProject string) *ProjectsServiceAccountGetCall { - c.urlParams_.Set("provisionalUserProject", provisionalUserProject) - return c -} - // UserProject sets the optional parameter "userProject": The project to // be billed for this request. func (c *ProjectsServiceAccountGetCall) UserProject(userProject string) *ProjectsServiceAccountGetCall { @@ -13657,11 +13064,6 @@ func (c *ProjectsServiceAccountGetCall) Do(opts ...googleapi.CallOption) (*Servi // "required": true, // "type": "string" // }, - // "provisionalUserProject": { - // "description": "The project to be billed for this request if the target bucket is requester-pays bucket.", - // "location": "query", - // "type": "string" - // }, // "userProject": { // "description": "The project to be billed for this request.", // "location": "query", diff --git a/sts/v1/sts-api.json b/sts/v1/sts-api.json index dcd11db2c91..8eacdc09f86 100644 --- a/sts/v1/sts-api.json +++ b/sts/v1/sts-api.json @@ -131,7 +131,7 @@ } } }, - "revision": "20211105", + "revision": "20220402", "rootUrl": "https://sts.googleapis.com/", "schemas": { "GoogleIamV1Binding": { @@ -143,7 +143,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" }, diff --git a/sts/v1/sts-gen.go b/sts/v1/sts-gen.go index a8b35d1feef..404a71aed68 100644 --- a/sts/v1/sts-gen.go +++ b/sts/v1/sts-gen.go @@ -147,8 +147,8 @@ type GoogleIamV1Binding struct { // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *GoogleTypeExpr `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 diff --git a/sts/v1beta/sts-api.json b/sts/v1beta/sts-api.json index 3b3f916daa1..133619d46c9 100644 --- a/sts/v1beta/sts-api.json +++ b/sts/v1beta/sts-api.json @@ -116,7 +116,7 @@ } } }, - "revision": "20211015", + "revision": "20220402", "rootUrl": "https://sts.googleapis.com/", "schemas": { "GoogleIamV1Binding": { @@ -128,7 +128,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" }, diff --git a/sts/v1beta/sts-gen.go b/sts/v1beta/sts-gen.go index cf84eb6f4f9..5df08c185f3 100644 --- a/sts/v1beta/sts-gen.go +++ b/sts/v1beta/sts-gen.go @@ -147,8 +147,8 @@ type GoogleIamV1Binding struct { // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *GoogleTypeExpr `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 diff --git a/transcoder/v1/transcoder-api.json b/transcoder/v1/transcoder-api.json index ac699ef297c..103c7d6aad3 100644 --- a/transcoder/v1/transcoder-api.json +++ b/transcoder/v1/transcoder-api.json @@ -385,7 +385,7 @@ } } }, - "revision": "20220131", + "revision": "20220323", "rootUrl": "https://transcoder.googleapis.com/", "schemas": { "AdBreak": { @@ -487,11 +487,11 @@ "id": "Audio", "properties": { "highBoost": { - "description": "Enable boosting high frequency components. The default is `false`.", + "description": "Enable boosting high frequency components. The default is `false`. **Note:** This field is not supported.", "type": "boolean" }, "lowBoost": { - "description": "Enable boosting low frequency components. The default is `false`.", + "description": "Enable boosting low frequency components. The default is `false`. **Note:** This field is not supported.", "type": "boolean" }, "lufs": { @@ -578,7 +578,7 @@ "type": "object" }, "Color": { - "description": "Color preprocessing configuration.", + "description": "Color preprocessing configuration. **Note:** This configuration is not supported.", "id": "Color", "properties": { "brightness": { @@ -627,7 +627,7 @@ "type": "object" }, "Deblock": { - "description": "Deblock preprocessing configuration.", + "description": "Deblock preprocessing configuration. **Note:** This configuration is not supported.", "id": "Deblock", "properties": { "enabled": { @@ -643,7 +643,7 @@ "type": "object" }, "Denoise": { - "description": "Denoise preprocessing configuration.", + "description": "Denoise preprocessing configuration. **Note:** This configuration is not supported.", "id": "Denoise", "properties": { "strength": { @@ -710,7 +710,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" @@ -940,7 +940,7 @@ "description": "Preprocessing configurations." }, "uri": { - "description": "URI of the media. Input files must be at least 5 seconds in duration and stored in Cloud Storage (for example, `gs://bucket/inputs/file.mp4`). If empty, the value will be populated from `Job.input_uri`.", + "description": "URI of the media. Input files must be at least 5 seconds in duration and stored in Cloud Storage (for example, `gs://bucket/inputs/file.mp4`). If empty, the value is populated from `Job.input_uri`. See [Supported input and output formats](https://cloud.google.com/transcoder/docs/concepts/supported-input-and-output-formats).", "type": "string" } }, @@ -972,7 +972,7 @@ "readOnly": true }, "inputUri": { - "description": "Input only. Specify the `input_uri` to populate empty `uri` fields in each element of `Job.config.inputs` or `JobTemplate.config.inputs` when using template. URI of the media. Input files must be at least 5 seconds in duration and stored in Cloud Storage (for example, `gs://bucket/inputs/file.mp4`).", + "description": "Input only. Specify the `input_uri` to populate empty `uri` fields in each element of `Job.config.inputs` or `JobTemplate.config.inputs` when using template. URI of the media. Input files must be at least 5 seconds in duration and stored in Cloud Storage (for example, `gs://bucket/inputs/file.mp4`). See [Supported input and output formats](https://cloud.google.com/transcoder/docs/concepts/supported-input-and-output-formats).", "type": "string" }, "name": { @@ -980,7 +980,7 @@ "type": "string" }, "outputUri": { - "description": "Input only. Specify the `output_uri` to populate an empty `Job.config.output.uri` or `JobTemplate.config.output.uri` when using template. URI for the output file(s). For example, `gs://my-bucket/outputs/`.", + "description": "Input only. Specify the `output_uri` to populate an empty `Job.config.output.uri` or `JobTemplate.config.output.uri` when using template. URI for the output file(s). For example, `gs://my-bucket/outputs/`. See [Supported input and output formats](https://cloud.google.com/transcoder/docs/concepts/supported-input-and-output-formats).", "type": "string" }, "startTime": { @@ -1193,7 +1193,7 @@ "id": "MuxStream", "properties": { "container": { - "description": "The container format. The default is `mp4` Supported container formats: - `ts` - `fmp4`- the corresponding file extension is `.m4s` - `mp4` - `vtt`", + "description": "The container format. The default is `mp4` Supported container formats: - `ts` - `fmp4`- the corresponding file extension is `.m4s` - `mp4` - `vtt` See also: [Supported input and output formats](https://cloud.google.com/transcoder/docs/concepts/supported-input-and-output-formats)", "type": "string" }, "elementaryStreams": { @@ -1240,7 +1240,7 @@ "id": "Output", "properties": { "uri": { - "description": "URI for the output file(s). For example, `gs://my-bucket/outputs/`. If empty the value is populated from `Job.output_uri`.", + "description": "URI for the output file(s). For example, `gs://my-bucket/outputs/`. If empty, the value is populated from `Job.output_uri`. See [Supported input and output formats](https://cloud.google.com/transcoder/docs/concepts/supported-input-and-output-formats).", "type": "string" } }, @@ -1503,7 +1503,7 @@ "type": "integer" }, "crfLevel": { - "description": "Target CRF level. Must be between 10 and 36, where 10 is the highest quality and 36 is the most efficient compression. The default is 21. *Note*: This field is not supported. ", + "description": "Target CRF level. Must be between 10 and 36, where 10 is the highest quality and 36 is the most efficient compression. The default is 21. **Note:** This field is not supported.", "format": "int32", "type": "integer" }, diff --git a/transcoder/v1/transcoder-gen.go b/transcoder/v1/transcoder-gen.go index ef581d5954b..a6f0dcf8a1d 100644 --- a/transcoder/v1/transcoder-gen.go +++ b/transcoder/v1/transcoder-gen.go @@ -366,11 +366,11 @@ func (s *AnimationStatic) MarshalJSON() ([]byte, error) { // Audio: Audio preprocessing configuration. type Audio struct { // HighBoost: Enable boosting high frequency components. The default is - // `false`. + // `false`. **Note:** This field is not supported. HighBoost bool `json:"highBoost,omitempty"` // LowBoost: Enable boosting low frequency components. The default is - // `false`. + // `false`. **Note:** This field is not supported. LowBoost bool `json:"lowBoost,omitempty"` // Lufs: Specify audio loudness normalization in loudness units relative @@ -537,7 +537,8 @@ func (s *AudioStream) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Color: Color preprocessing configuration. +// Color: Color preprocessing configuration. **Note:** This +// configuration is not supported. type Color struct { // Brightness: Control brightness of the video. Enter a value between -1 // and 1, where -1 is minimum brightness and 1 is maximum brightness. 0 @@ -637,7 +638,8 @@ func (s *Crop) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Deblock: Deblock preprocessing configuration. +// Deblock: Deblock preprocessing configuration. **Note:** This +// configuration is not supported. type Deblock struct { // Enabled: Enable deblocker. The default is `false`. Enabled bool `json:"enabled,omitempty"` @@ -684,7 +686,8 @@ func (s *Deblock) UnmarshalJSON(data []byte) error { return nil } -// Denoise: Denoise preprocessing configuration. +// Denoise: Denoise preprocessing configuration. **Note:** This +// configuration is not supported. type Denoise struct { // Strength: Set strength of the denoise. Enter a value between 0 and 1. // The higher the value, the smoother the image. 0 is no denoising. The @@ -818,8 +821,7 @@ func (s *ElementaryStream) 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. @@ -1198,8 +1200,9 @@ type Input struct { // Uri: URI of the media. Input files must be at least 5 seconds in // duration and stored in Cloud Storage (for example, - // `gs://bucket/inputs/file.mp4`). If empty, the value will be populated - // from `Job.input_uri`. + // `gs://bucket/inputs/file.mp4`). If empty, the value is populated from + // `Job.input_uri`. See Supported input and output formats + // (https://cloud.google.com/transcoder/docs/concepts/supported-input-and-output-formats). Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Key") to @@ -1244,7 +1247,9 @@ type Job struct { // fields in each element of `Job.config.inputs` or // `JobTemplate.config.inputs` when using template. URI of the media. // Input files must be at least 5 seconds in duration and stored in - // Cloud Storage (for example, `gs://bucket/inputs/file.mp4`). + // Cloud Storage (for example, `gs://bucket/inputs/file.mp4`). See + // Supported input and output formats + // (https://cloud.google.com/transcoder/docs/concepts/supported-input-and-output-formats). InputUri string `json:"inputUri,omitempty"` // Name: The resource name of the job. Format: @@ -1254,7 +1259,8 @@ type Job struct { // OutputUri: Input only. Specify the `output_uri` to populate an empty // `Job.config.output.uri` or `JobTemplate.config.output.uri` when using // template. URI for the output file(s). For example, - // `gs://my-bucket/outputs/`. + // `gs://my-bucket/outputs/`. See Supported input and output formats + // (https://cloud.google.com/transcoder/docs/concepts/supported-input-and-output-formats). OutputUri string `json:"outputUri,omitempty"` // StartTime: Output only. The time the transcoding started. @@ -1533,7 +1539,9 @@ func (s *Manifest) MarshalJSON() ([]byte, error) { type MuxStream struct { // Container: The container format. The default is `mp4` Supported // container formats: - `ts` - `fmp4`- the corresponding file extension - // is `.m4s` - `mp4` - `vtt` + // is `.m4s` - `mp4` - `vtt` See also: Supported input and output + // formats + // (https://cloud.google.com/transcoder/docs/concepts/supported-input-and-output-formats) Container string `json:"container,omitempty"` // ElementaryStreams: List of `ElementaryStream.key`s multiplexed in @@ -1628,8 +1636,9 @@ func (s *NormalizedCoordinate) UnmarshalJSON(data []byte) error { // Output: Location of output file(s) in a Cloud Storage bucket. type Output struct { // Uri: URI for the output file(s). For example, - // `gs://my-bucket/outputs/`. If empty the value is populated from - // `Job.output_uri`. + // `gs://my-bucket/outputs/`. If empty, the value is populated from + // `Job.output_uri`. See Supported input and output formats + // (https://cloud.google.com/transcoder/docs/concepts/supported-input-and-output-formats). Uri string `json:"uri,omitempty"` // ForceSendFields is a list of field names (e.g. "Uri") to @@ -2077,7 +2086,7 @@ type Vp9CodecSettings struct { // CrfLevel: Target CRF level. Must be between 10 and 36, where 10 is // the highest quality and 36 is the most efficient compression. The - // default is 21. *Note*: This field is not supported. + // default is 21. **Note:** This field is not supported. CrfLevel int64 `json:"crfLevel,omitempty"` // FrameRate: Required. The target video frame rate in frames per second diff --git a/translate/v3/translate-api.json b/translate/v3/translate-api.json index b6966a02c58..4aad0896707 100644 --- a/translate/v3/translate-api.json +++ b/translate/v3/translate-api.json @@ -365,7 +365,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" }, @@ -744,7 +744,7 @@ } } }, - "revision": "20211029", + "revision": "20220401", "rootUrl": "https://translation.googleapis.com/", "schemas": { "BatchDocumentInputConfig": { @@ -990,7 +990,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/translate/v3/translate-gen.go b/translate/v3/translate-gen.go index ce911e44de4..693058d6ad1 100644 --- a/translate/v3/translate-gen.go +++ b/translate/v3/translate-gen.go @@ -726,8 +726,7 @@ func (s *DocumentTranslation) 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. @@ -3092,8 +3091,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 @@ -3222,7 +3221,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/translate/v3beta1/translate-api.json b/translate/v3beta1/translate-api.json index f6c6aa480fc..51903a56278 100644 --- a/translate/v3beta1/translate-api.json +++ b/translate/v3beta1/translate-api.json @@ -365,7 +365,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" }, @@ -744,7 +744,7 @@ } } }, - "revision": "20211029", + "revision": "20220401", "rootUrl": "https://translation.googleapis.com/", "schemas": { "BatchDocumentInputConfig": { @@ -990,7 +990,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/translate/v3beta1/translate-gen.go b/translate/v3beta1/translate-gen.go index a1de88f80d7..21f741b9b7a 100644 --- a/translate/v3beta1/translate-gen.go +++ b/translate/v3beta1/translate-gen.go @@ -725,8 +725,7 @@ func (s *DocumentTranslation) 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. @@ -3086,8 +3085,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 @@ -3216,7 +3215,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/vault/v1/vault-api.json b/vault/v1/vault-api.json index 910d06cb0c5..8c1dac39997 100644 --- a/vault/v1/vault-api.json +++ b/vault/v1/vault-api.json @@ -1193,7 +1193,7 @@ } } }, - "revision": "20220316", + "revision": "20220331", "rootUrl": "https://vault.googleapis.com/", "schemas": { "AccountCount": { @@ -1499,6 +1499,22 @@ "description": "Additional options for Drive search", "id": "DriveOptions", "properties": { + "clientSideEncryptedOption": { + "description": "Set whether the results include only content encrypted with [Google Workspace Client-side encryption](https://support.google.com/a?p=cse_ov) content, only unencrypted content, or both. Defaults to both. Currently supported for Drive.", + "enum": [ + "CLIENT_SIDE_ENCRYPTED_OPTION_UNSPECIFIED", + "CLIENT_SIDE_ENCRYPTED_OPTION_ANY", + "CLIENT_SIDE_ENCRYPTED_OPTION_ENCRYPTED", + "CLIENT_SIDE_ENCRYPTED_OPTION_UNENCRYPTED" + ], + "enumDescriptions": [ + "Encryption status unspecified. Results include both client-side encrypted and non-encrypted content.", + "Include both client-side encrypted and unencrypted content in results.", + "Include client-side encrypted content only.", + "Include unencrypted content only." + ], + "type": "string" + }, "includeSharedDrives": { "description": "Set to **true** to include shared drives.", "type": "boolean" @@ -1516,7 +1532,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/vault/v1/vault-gen.go b/vault/v1/vault-gen.go index 481481c7cfc..13ba184a1a5 100644 --- a/vault/v1/vault-gen.go +++ b/vault/v1/vault-gen.go @@ -761,6 +761,23 @@ func (s *DriveExportOptions) MarshalJSON() ([]byte, error) { // DriveOptions: Additional options for Drive search type DriveOptions struct { + // ClientSideEncryptedOption: Set whether the results include only + // content encrypted with Google Workspace Client-side encryption + // (https://support.google.com/a?p=cse_ov) content, only unencrypted + // content, or both. Defaults to both. Currently supported for Drive. + // + // Possible values: + // "CLIENT_SIDE_ENCRYPTED_OPTION_UNSPECIFIED" - Encryption status + // unspecified. Results include both client-side encrypted and + // non-encrypted content. + // "CLIENT_SIDE_ENCRYPTED_OPTION_ANY" - Include both client-side + // encrypted and unencrypted content in results. + // "CLIENT_SIDE_ENCRYPTED_OPTION_ENCRYPTED" - Include client-side + // encrypted content only. + // "CLIENT_SIDE_ENCRYPTED_OPTION_UNENCRYPTED" - Include unencrypted + // content only. + ClientSideEncryptedOption string `json:"clientSideEncryptedOption,omitempty"` + // IncludeSharedDrives: Set to **true** to include shared drives. IncludeSharedDrives bool `json:"includeSharedDrives,omitempty"` @@ -772,21 +789,22 @@ type DriveOptions struct { // specified date. Enter the date in UTC. VersionDate string `json:"versionDate,omitempty"` - // ForceSendFields is a list of field names (e.g. "IncludeSharedDrives") - // 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 is a list of field names (e.g. + // "ClientSideEncryptedOption") 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. "IncludeSharedDrives") 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 is a list of field names (e.g. + // "ClientSideEncryptedOption") 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:"-"` } @@ -800,8 +818,7 @@ func (s *DriveOptions) 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. diff --git a/youtube/v3/youtube-api.json b/youtube/v3/youtube-api.json index 850a95d564e..16cea4b66d0 100644 --- a/youtube/v3/youtube-api.json +++ b/youtube/v3/youtube-api.json @@ -3398,7 +3398,7 @@ "video/*", "application/octet-stream" ], - "maxSize": "137438953472", + "maxSize": "274877906944", "protocols": { "resumable": { "multipart": true, @@ -3789,7 +3789,7 @@ } } }, - "revision": "20220321", + "revision": "20220405", "rootUrl": "https://youtube.googleapis.com/", "schemas": { "AbuseReport": { diff --git a/youtube/v3/youtube-gen.go b/youtube/v3/youtube-gen.go index faa841e13c7..4046dc670ee 100644 --- a/youtube/v3/youtube-gen.go +++ b/youtube/v3/youtube-gen.go @@ -23631,7 +23631,7 @@ func (c *VideosInsertCall) Do(opts ...googleapi.CallOption) (*Video, error) { // "video/*", // "application/octet-stream" // ], - // "maxSize": "137438953472", + // "maxSize": "274877906944", // "protocols": { // "resumable": { // "multipart": true, From d349e8569473af826a87ebbeff59c90455f8490f Mon Sep 17 00:00:00 2001 From: Mohan Li <67390330+mohanli-ml@users.noreply.github.com> Date: Mon, 11 Apr 2022 08:23:20 -0700 Subject: [PATCH 06/17] feat(transport): remove grpc version guard (#1506) --- transport/grpc/dial.go | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/transport/grpc/dial.go b/transport/grpc/dial.go index d25497868ca..c86f56507f5 100644 --- a/transport/grpc/dial.go +++ b/transport/grpc/dial.go @@ -150,8 +150,7 @@ func dial(ctx context.Context, insecure bool, o *internal.DialSettings) (*grpc.C grpcOpts = append(grpcOpts, timeoutDialerOption) } // Check if google-c2p resolver is enabled for DirectPath - // TODO(mohanli): remove grpc version guard once google-api-go-client is able to depends on the latest grpc - if grpc.Version >= "1.42" && strings.EqualFold(os.Getenv(enableDirectPathXds), "true") { + if strings.EqualFold(os.Getenv(enableDirectPathXds), "true") { // google-c2p resolver target must not have a port number if addr, _, err := net.SplitHostPort(endpoint); err == nil { endpoint = "google-c2p-experimental:///" + addr From d621bc9f08f18d7f1485fd091765b014587cd759 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Mon, 11 Apr 2022 12:30:03 -0700 Subject: [PATCH 07/17] feat(all): auto-regenerate discovery clients (#1504) --- .../v1beta1/artifactregistry-api.json | 4 +- .../v1beta1/artifactregistry-gen.go | 6 +- calendar/v3/calendar-api.json | 6 +- calendar/v3/calendar-gen.go | 6 +- chat/v1/chat-api.json | 27 +- chat/v1/chat-gen.go | 36 +-- clouddeploy/v1/clouddeploy-api.json | 4 +- clouddeploy/v1/clouddeploy-gen.go | 3 +- cloudkms/v1/cloudkms-api.json | 4 +- cloudkms/v1/cloudkms-gen.go | 6 +- documentai/v1/documentai-api.json | 8 +- documentai/v1/documentai-gen.go | 14 +- documentai/v1beta3/documentai-api.json | 6 +- documentai/v1beta3/documentai-gen.go | 8 +- gkehub/v1alpha/gkehub-api.json | 6 +- gkehub/v1alpha/gkehub-gen.go | 10 +- gkehub/v1alpha2/gkehub-api.json | 4 +- gkehub/v1alpha2/gkehub-gen.go | 6 +- gkehub/v2alpha/gkehub-api.json | 4 +- gkehub/v2alpha/gkehub-gen.go | 6 +- iam/v1/iam-api.json | 6 +- iam/v1/iam-gen.go | 16 +- metastore/v1beta/metastore-api.json | 4 +- metastore/v1beta/metastore-gen.go | 3 +- mybusinessqanda/v1/mybusinessqanda-api.json | 50 ++-- mybusinessqanda/v1/mybusinessqanda-gen.go | 265 +++++++++--------- .../v1beta1/networkservices-api.json | 54 +--- .../v1beta1/networkservices-gen.go | 186 +----------- .../v1beta/servicenetworking-api.json | 8 +- .../v1beta/servicenetworking-gen.go | 19 +- 30 files changed, 300 insertions(+), 485 deletions(-) diff --git a/artifactregistry/v1beta1/artifactregistry-api.json b/artifactregistry/v1beta1/artifactregistry-api.json index 9fa80bc1686..12b5d192b2b 100644 --- a/artifactregistry/v1beta1/artifactregistry-api.json +++ b/artifactregistry/v1beta1/artifactregistry-api.json @@ -148,7 +148,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" }, @@ -929,7 +929,7 @@ } } }, - "revision": "20220328", + "revision": "20220401", "rootUrl": "https://artifactregistry.googleapis.com/", "schemas": { "Binding": { diff --git a/artifactregistry/v1beta1/artifactregistry-gen.go b/artifactregistry/v1beta1/artifactregistry-gen.go index 748157e6a57..36e9c43f4d6 100644 --- a/artifactregistry/v1beta1/artifactregistry-gen.go +++ b/artifactregistry/v1beta1/artifactregistry-gen.go @@ -1430,8 +1430,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 @@ -1560,7 +1560,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/calendar/v3/calendar-api.json b/calendar/v3/calendar-api.json index 78816dfc86b..f69d44fd8b0 100644 --- a/calendar/v3/calendar-api.json +++ b/calendar/v3/calendar-api.json @@ -1723,7 +1723,7 @@ } } }, - "revision": "20220203", + "revision": "20220401", "rootUrl": "https://www.googleapis.com/", "schemas": { "Acl": { @@ -2300,7 +2300,7 @@ "type": "boolean" }, "attachments": { - "description": "File attachments for the event. Currently only Google Drive attachments are supported.\nIn order to modify attachments the supportsAttachments request parameter should be set to true.\nThere can be at most 25 attachments per event,", + "description": "File attachments for the event.\nIn order to modify attachments the supportsAttachments request parameter should be set to true.\nThere can be at most 25 attachments per event,", "items": { "$ref": "EventAttachment" }, @@ -2627,7 +2627,7 @@ "type": "string" }, "iconLink": { - "description": "URL link to the attachment's icon. Read-only.", + "description": "URL link to the attachment's icon. This field can only be modified for custom third-party attachments.", "type": "string" }, "mimeType": { diff --git a/calendar/v3/calendar-gen.go b/calendar/v3/calendar-gen.go index 04ada2c49d5..f5d3bc20ac5 100644 --- a/calendar/v3/calendar-gen.go +++ b/calendar/v3/calendar-gen.go @@ -1302,8 +1302,7 @@ type Event struct { // (deprecated). Optional. The default is False. AnyoneCanAddSelf bool `json:"anyoneCanAddSelf,omitempty"` - // Attachments: File attachments for the event. Currently only Google - // Drive attachments are supported. + // Attachments: File attachments for the event. // In order to modify attachments the supportsAttachments request // parameter should be set to true. // There can be at most 25 attachments per event, @@ -1828,7 +1827,8 @@ type EventAttachment struct { // Required when adding an attachment. FileUrl string `json:"fileUrl,omitempty"` - // IconLink: URL link to the attachment's icon. Read-only. + // IconLink: URL link to the attachment's icon. This field can only be + // modified for custom third-party attachments. IconLink string `json:"iconLink,omitempty"` // MimeType: Internet media type (MIME type) of the attachment. diff --git a/chat/v1/chat-api.json b/chat/v1/chat-api.json index 571c431560d..8599a86289a 100644 --- a/chat/v1/chat-api.json +++ b/chat/v1/chat-api.json @@ -642,7 +642,7 @@ } } }, - "revision": "20220329", + "revision": "20220405", "rootUrl": "https://chat.googleapis.com/", "schemas": { "ActionParameter": { @@ -696,7 +696,7 @@ "type": "object" }, "ActionStatus": { - "description": "Represents the status of a request.", + "description": "Represents the status for a request to either invoke or submit a [dialog](https://developers.google.com/chat/how-tos/dialogs).", "id": "ActionStatus", "properties": { "statusCode": { @@ -805,6 +805,7 @@ }, "downloadUri": { "description": "Output only. The download URL which should be used to allow a human user to download the attachment. Chat apps should not use this URL to download attachment content.", + "readOnly": true, "type": "string" }, "driveDataRef": { @@ -831,6 +832,7 @@ }, "thumbnailUri": { "description": "Output only. The thumbnail URL which should be used to preview the attachment to a human user. Chat apps should not use this URL to download attachment content.", + "readOnly": true, "type": "string" } }, @@ -1128,7 +1130,7 @@ "type": "string" }, "token": { - "description": "A secret value that Chat apps can use to verify if a request is from Google. The token is randomly generated by Google, remains static, and can be obtained from the Google Chat API configuration page in the Cloud Console. Developers can revoke/regenerate it if needed from the same page.", + "description": "A secret value that legacy Chat apps can use to verify if a request is from Google. Google randomly generates the token, and its value remains static. You can obtain, revoke, or regenerate the token from the [Chat API configuration page](https://console.cloud.google.com/apis/api/chat.googleapis.com/hangouts-chat) in the Google Cloud Console. Modern Chat apps don't use this field. It is absent from API responses and the [Chat API configuration page](https://console.cloud.google.com/apis/api/chat.googleapis.com/hangouts-chat).", "type": "string" }, "type": { @@ -2355,11 +2357,12 @@ "type": "object" }, "MatchedUrl": { - "description": "A matched url in a Chat message. Chat apps can unfurl matched URLs. For more information, refer to [Unfurl links](/chat/how-tos/link-unfurling).", + "description": "A matched url in a Chat message. Chat apps can unfurl matched URLs. For more information, refer to [Unfurl links](https://developers.google.com/chat/how-tos/link-unfurling).", "id": "MatchedUrl", "properties": { "url": { - "description": "The url that was matched.", + "description": "Output only. The url that was matched.", + "readOnly": true, "type": "string" } }, @@ -2388,7 +2391,8 @@ }, "member": { "$ref": "User", - "description": "A user in Google Chat. Represents a [person](https://developers.google.com/people/api/rest/v1/people) in the People API or a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. Format: `users/{user}`" + "description": "Output only. A user in Google Chat. Represents a [person](https://developers.google.com/people/api/rest/v1/people) in the People API or a [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. Format: `users/{user}`", + "readOnly": true }, "name": { "type": "string" @@ -2609,12 +2613,12 @@ "type": "boolean" }, "threaded": { - "description": "Output only. Whether the messages are threaded in this space.", + "description": "Output only. Output only. Whether the messages are threaded in this space.", "readOnly": true, "type": "boolean" }, "type": { - "description": "Deprecated. Use `single_user_bot_dm` instead. Output only. The type of a space.", + "description": "Output only. Deprecated: Use `single_user_bot_dm` instead. Output only. The type of a space.", "enum": [ "TYPE_UNSPECIFIED", "ROOM", @@ -2625,6 +2629,7 @@ "Conversations between two or more humans.", "1:1 Direct Message between a human and a Chat app, where all messages are flat. Note that this does not include direct messages between two humans." ], + "readOnly": true, "type": "string" } }, @@ -2745,7 +2750,8 @@ "id": "User", "properties": { "displayName": { - "description": "The user's display name.", + "description": "Output only. The user's display name.", + "readOnly": true, "type": "string" }, "domainId": { @@ -2753,7 +2759,8 @@ "type": "string" }, "isAnonymous": { - "description": "When `true`, the user is deleted or their profile is not visible.", + "description": "Output only. When `true`, the user is deleted or their profile is not visible.", + "readOnly": true, "type": "boolean" }, "name": { diff --git a/chat/v1/chat-gen.go b/chat/v1/chat-gen.go index 19bca7992c5..63862671e11 100644 --- a/chat/v1/chat-gen.go +++ b/chat/v1/chat-gen.go @@ -318,7 +318,8 @@ func (s *ActionResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// ActionStatus: Represents the status of a request. +// ActionStatus: Represents the status for a request to either invoke or +// submit a dialog (https://developers.google.com/chat/how-tos/dialogs). type ActionStatus struct { // StatusCode: The status code. // @@ -1059,11 +1060,14 @@ type DeprecatedEvent struct { // request for more information. ThreadKey string `json:"threadKey,omitempty"` - // Token: A secret value that Chat apps can use to verify if a request - // is from Google. The token is randomly generated by Google, remains - // static, and can be obtained from the Google Chat API configuration - // page in the Cloud Console. Developers can revoke/regenerate it if - // needed from the same page. + // Token: A secret value that legacy Chat apps can use to verify if a + // request is from Google. Google randomly generates the token, and its + // value remains static. You can obtain, revoke, or regenerate the token + // from the Chat API configuration page + // (https://console.cloud.google.com/apis/api/chat.googleapis.com/hangouts-chat) + // in the Google Cloud Console. Modern Chat apps don't use this field. + // It is absent from API responses and the Chat API configuration page + // (https://console.cloud.google.com/apis/api/chat.googleapis.com/hangouts-chat). Token string `json:"token,omitempty"` // Type: The type of the event. @@ -2946,9 +2950,9 @@ func (s *ListSpacesResponse) MarshalJSON() ([]byte, error) { // MatchedUrl: A matched url in a Chat message. Chat apps can unfurl // matched URLs. For more information, refer to Unfurl links -// (/chat/how-tos/link-unfurling). +// (https://developers.google.com/chat/how-tos/link-unfurling). type MatchedUrl struct { - // Url: The url that was matched. + // Url: Output only. The url that was matched. Url string `json:"url,omitempty"` // ForceSendFields is a list of field names (e.g. "Url") to @@ -3012,7 +3016,7 @@ type Membership struct { // the time at which the member joined the space, if applicable. CreateTime string `json:"createTime,omitempty"` - // Member: A user in Google Chat. Represents a person + // Member: Output only. A user in Google Chat. Represents a person // (https://developers.google.com/people/api/rest/v1/people) in the // People API or a user // (https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) @@ -3332,12 +3336,12 @@ type Space struct { // Chat app and a single human. SingleUserBotDm bool `json:"singleUserBotDm,omitempty"` - // Threaded: Output only. Whether the messages are threaded in this - // space. + // Threaded: Output only. Output only. Whether the messages are threaded + // in this space. Threaded bool `json:"threaded,omitempty"` - // Type: Deprecated. Use `single_user_bot_dm` instead. Output only. The - // type of a space. + // Type: Output only. Deprecated: Use `single_user_bot_dm` instead. + // Output only. The type of a space. // // Possible values: // "TYPE_UNSPECIFIED" @@ -3603,14 +3607,14 @@ func (s *TimeZone) MarshalJSON() ([]byte, error) { // User: A user in Google Chat. type User struct { - // DisplayName: The user's display name. + // DisplayName: Output only. The user's display name. DisplayName string `json:"displayName,omitempty"` // DomainId: Unique identifier of the user's Google Workspace domain. DomainId string `json:"domainId,omitempty"` - // IsAnonymous: When `true`, the user is deleted or their profile is not - // visible. + // IsAnonymous: Output only. When `true`, the user is deleted or their + // profile is not visible. IsAnonymous bool `json:"isAnonymous,omitempty"` // Name: Resource name for a Google Chat user. Represents a person diff --git a/clouddeploy/v1/clouddeploy-api.json b/clouddeploy/v1/clouddeploy-api.json index bd7a19283b6..a7351c29744 100644 --- a/clouddeploy/v1/clouddeploy-api.json +++ b/clouddeploy/v1/clouddeploy-api.json @@ -1201,7 +1201,7 @@ } } }, - "revision": "20220314", + "revision": "20220330", "rootUrl": "https://clouddeploy.googleapis.com/", "schemas": { "AnthosCluster": { @@ -1444,7 +1444,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/clouddeploy/v1/clouddeploy-gen.go b/clouddeploy/v1/clouddeploy-gen.go index 62e4d9990a2..a2c98aed904 100644 --- a/clouddeploy/v1/clouddeploy-gen.go +++ b/clouddeploy/v1/clouddeploy-gen.go @@ -702,8 +702,7 @@ func (s *DeliveryPipeline) 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. diff --git a/cloudkms/v1/cloudkms-api.json b/cloudkms/v1/cloudkms-api.json index 5cd9610bdde..d14b7fc9add 100644 --- a/cloudkms/v1/cloudkms-api.json +++ b/cloudkms/v1/cloudkms-api.json @@ -177,7 +177,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" }, @@ -1582,7 +1582,7 @@ } } }, - "revision": "20220325", + "revision": "20220407", "rootUrl": "https://cloudkms.googleapis.com/", "schemas": { "AsymmetricDecryptRequest": { diff --git a/cloudkms/v1/cloudkms-gen.go b/cloudkms/v1/cloudkms-gen.go index 6cb593d95f5..d2a9184889d 100644 --- a/cloudkms/v1/cloudkms-gen.go +++ b/cloudkms/v1/cloudkms-gen.go @@ -3415,8 +3415,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 @@ -3545,7 +3545,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/documentai/v1/documentai-api.json b/documentai/v1/documentai-api.json index 8940aea0b7d..e588dce6b22 100644 --- a/documentai/v1/documentai-api.json +++ b/documentai/v1/documentai-api.json @@ -198,7 +198,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" }, @@ -894,7 +894,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" }, @@ -1029,7 +1029,7 @@ } } }, - "revision": "20220326", + "revision": "20220401", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3BatchDeleteDocumentsMetadata": { @@ -3180,7 +3180,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1ProcessorVersion": { - "description": "A processor version is an implementation of a processor. Each processor can have multiple versions, pre-trained by Google internally or up-trained by the customer. At a time, a processor can only have one default version version. So the processor's behavior (when processing documents) is defined by a default version.", + "description": "A processor version is an implementation of a processor. Each processor can have multiple versions, pre-trained by Google internally or up-trained by the customer. At a time, a processor can only have one default version version. So the processor's behavior (when processing documents) is defined by a default version", "id": "GoogleCloudDocumentaiV1ProcessorVersion", "properties": { "createTime": { diff --git a/documentai/v1/documentai-gen.go b/documentai/v1/documentai-gen.go index b113955d6ef..70ebb898587 100644 --- a/documentai/v1/documentai-gen.go +++ b/documentai/v1/documentai-gen.go @@ -3967,7 +3967,7 @@ func (s *GoogleCloudDocumentaiV1ProcessorTypeLocationInfo) MarshalJSON() ([]byte // versions, pre-trained by Google internally or up-trained by the // customer. At a time, a processor can only have one default version // version. So the processor's behavior (when processing documents) is -// defined by a default version. +// defined by a default version type GoogleCloudDocumentaiV1ProcessorVersion struct { // CreateTime: The time the processor version was created. CreateTime string `json:"createTime,omitempty"` @@ -9980,8 +9980,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 @@ -10112,7 +10112,7 @@ func (c *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*GoogleClo // ], // "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" // }, @@ -13540,8 +13540,8 @@ func (r *Uiv1beta3ProjectsLocationsService) List(name string) *Uiv1beta3Projects // 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 *Uiv1beta3ProjectsLocationsListCall) Filter(filter string) *Uiv1beta3ProjectsLocationsListCall { c.urlParams_.Set("filter", filter) return c @@ -13672,7 +13672,7 @@ func (c *Uiv1beta3ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (* // ], // "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/documentai/v1beta3/documentai-api.json b/documentai/v1beta3/documentai-api.json index 6a9ce968727..cb36e62ffb1 100644 --- a/documentai/v1beta3/documentai-api.json +++ b/documentai/v1beta3/documentai-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" }, @@ -796,7 +796,7 @@ } } }, - "revision": "20220326", + "revision": "20220401", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3BatchDeleteDocumentsMetadata": { @@ -5754,7 +5754,7 @@ "type": "object" }, "GoogleCloudDocumentaiV1beta3ProcessorVersion": { - "description": "A processor version is an implementation of a processor. Each processor can have multiple versions, pre-trained by Google internally or up-trained by the customer. At a time, a processor can only have one default version version. So the processor's behavior (when processing documents) is defined by a default version.", + "description": "A processor version is an implementation of a processor. Each processor can have multiple versions, pre-trained by Google internally or up-trained by the customer. At a time, a processor can only have one default version version. So the processor's behavior (when processing documents) is defined by a default version", "id": "GoogleCloudDocumentaiV1beta3ProcessorVersion", "properties": { "createTime": { diff --git a/documentai/v1beta3/documentai-gen.go b/documentai/v1beta3/documentai-gen.go index 0f201f6ccd5..aaa8b025066 100644 --- a/documentai/v1beta3/documentai-gen.go +++ b/documentai/v1beta3/documentai-gen.go @@ -8485,7 +8485,7 @@ func (s *GoogleCloudDocumentaiV1beta3ProcessorTypeLocationInfo) MarshalJSON() ([ // versions, pre-trained by Google internally or up-trained by the // customer. At a time, a processor can only have one default version // version. So the processor's behavior (when processing documents) is -// defined by a default version. +// defined by a default version type GoogleCloudDocumentaiV1beta3ProcessorVersion struct { // CreateTime: The time the processor version was created. CreateTime string `json:"createTime,omitempty"` @@ -9861,8 +9861,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 @@ -9993,7 +9993,7 @@ func (c *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*GoogleClo // ], // "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/gkehub/v1alpha/gkehub-api.json b/gkehub/v1alpha/gkehub-api.json index 53f473c778b..5ab1fd82a27 100644 --- a/gkehub/v1alpha/gkehub-api.json +++ b/gkehub/v1alpha/gkehub-api.json @@ -186,7 +186,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" }, @@ -1139,7 +1139,7 @@ } } }, - "revision": "20220318", + "revision": "20220401", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AnthosObservabilityFeatureSpec": { @@ -2484,7 +2484,7 @@ "type": "string" }, "clientSecret": { - "description": "Unencrypted OIDC client secret will be passed to the GKE Hub CLH.", + "description": "Input only. Unencrypted OIDC client secret will be passed to the GKE Hub CLH.", "type": "string" }, "deployCloudConsoleProxy": { diff --git a/gkehub/v1alpha/gkehub-gen.go b/gkehub/v1alpha/gkehub-gen.go index 164d99e65d1..e570f555777 100644 --- a/gkehub/v1alpha/gkehub-gen.go +++ b/gkehub/v1alpha/gkehub-gen.go @@ -2433,8 +2433,8 @@ type IdentityServiceOidcConfig struct { // ClientId: ID for OIDC client application. ClientId string `json:"clientId,omitempty"` - // ClientSecret: Unencrypted OIDC client secret will be passed to the - // GKE Hub CLH. + // ClientSecret: Input only. Unencrypted OIDC client secret will be + // passed to the GKE Hub CLH. ClientSecret string `json:"clientSecret,omitempty"` // DeployCloudConsoleProxy: Flag to denote if reverse proxy is used to @@ -4812,8 +4812,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 @@ -4942,7 +4942,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/gkehub/v1alpha2/gkehub-api.json b/gkehub/v1alpha2/gkehub-api.json index 1569dfbaa8f..f51b2fd1154 100644 --- a/gkehub/v1alpha2/gkehub-api.json +++ b/gkehub/v1alpha2/gkehub-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" }, @@ -652,7 +652,7 @@ } } }, - "revision": "20220318", + "revision": "20220401", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AuditConfig": { diff --git a/gkehub/v1alpha2/gkehub-gen.go b/gkehub/v1alpha2/gkehub-gen.go index bd3720e5bfb..2475e606f25 100644 --- a/gkehub/v1alpha2/gkehub-gen.go +++ b/gkehub/v1alpha2/gkehub-gen.go @@ -1902,8 +1902,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 @@ -2032,7 +2032,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/gkehub/v2alpha/gkehub-api.json b/gkehub/v2alpha/gkehub-api.json index 3e3c1367ef6..126c9af5418 100644 --- a/gkehub/v2alpha/gkehub-api.json +++ b/gkehub/v2alpha/gkehub-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" }, @@ -280,7 +280,7 @@ } } }, - "revision": "20220318", + "revision": "20220401", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "CancelOperationRequest": { diff --git a/gkehub/v2alpha/gkehub-gen.go b/gkehub/v2alpha/gkehub-gen.go index f4913d847d6..bfcb3dba754 100644 --- a/gkehub/v2alpha/gkehub-gen.go +++ b/gkehub/v2alpha/gkehub-gen.go @@ -586,8 +586,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 @@ -716,7 +716,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/iam/v1/iam-api.json b/iam/v1/iam-api.json index 862bcee7120..24824d069fc 100644 --- a/iam/v1/iam-api.json +++ b/iam/v1/iam-api.json @@ -1790,7 +1790,7 @@ ] }, "upload": { - "description": "Creates a ServiceAccountKey, using a public key that you provide.", + "description": "Uploads the public key portion of a key pair that you manage, and associates the public key with a ServiceAccount. After you upload the public key, you can use the private key from the key pair as a service account key.", "flatPath": "v1/projects/{projectsId}/serviceAccounts/{serviceAccountsId}/keys:upload", "httpMethod": "POST", "id": "iam.projects.serviceAccounts.keys.upload", @@ -1921,7 +1921,7 @@ } } }, - "revision": "20220324", + "revision": "20220331", "rootUrl": "https://iam.googleapis.com/", "schemas": { "AdminAuditData": { @@ -3030,7 +3030,7 @@ "id": "UploadServiceAccountKeyRequest", "properties": { "publicKeyData": { - "description": "A field that allows clients to upload their own public key. If set, use this public key data to create a service account key for given service account. Please note, the expected format for this field is X509_PEM.", + "description": "The public key to associate with the service account. Must be an RSA public key that is wrapped in an X.509 v3 certificate. Include the first line, `-----BEGIN CERTIFICATE-----`, and the last line, `-----END CERTIFICATE-----`.", "format": "byte", "type": "string" } diff --git a/iam/v1/iam-gen.go b/iam/v1/iam-gen.go index f64240d12f5..c4185d5feb7 100644 --- a/iam/v1/iam-gen.go +++ b/iam/v1/iam-gen.go @@ -2567,10 +2567,10 @@ type UndeleteWorkloadIdentityPoolRequest struct { // UploadServiceAccountKeyRequest: The service account key upload // request. type UploadServiceAccountKeyRequest struct { - // PublicKeyData: A field that allows clients to upload their own public - // key. If set, use this public key data to create a service account key - // for given service account. Please note, the expected format for this - // field is X509_PEM. + // PublicKeyData: The public key to associate with the service account. + // Must be an RSA public key that is wrapped in an X.509 v3 certificate. + // Include the first line, `-----BEGIN CERTIFICATE-----`, and the last + // line, `-----END CERTIFICATE-----`. PublicKeyData string `json:"publicKeyData,omitempty"` // ForceSendFields is a list of field names (e.g. "PublicKeyData") to @@ -11489,8 +11489,10 @@ type ProjectsServiceAccountsKeysUploadCall struct { header_ http.Header } -// Upload: Creates a ServiceAccountKey, using a public key that you -// provide. +// Upload: Uploads the public key portion of a key pair that you manage, +// and associates the public key with a ServiceAccount. After you upload +// the public key, you can use the private key from the key pair as a +// service account key. // // - name: The resource name of the service account in the following // format: `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. Using @@ -11595,7 +11597,7 @@ func (c *ProjectsServiceAccountsKeysUploadCall) Do(opts ...googleapi.CallOption) } return ret, nil // { - // "description": "Creates a ServiceAccountKey, using a public key that you provide.", + // "description": "Uploads the public key portion of a key pair that you manage, and associates the public key with a ServiceAccount. After you upload the public key, you can use the private key from the key pair as a service account key.", // "flatPath": "v1/projects/{projectsId}/serviceAccounts/{serviceAccountsId}/keys:upload", // "httpMethod": "POST", // "id": "iam.projects.serviceAccounts.keys.upload", diff --git a/metastore/v1beta/metastore-api.json b/metastore/v1beta/metastore-api.json index b638ebe3bf1..7fa4963ef6e 100644 --- a/metastore/v1beta/metastore-api.json +++ b/metastore/v1beta/metastore-api.json @@ -1198,7 +1198,7 @@ } } }, - "revision": "20220205", + "revision": "20220331", "rootUrl": "https://metastore.googleapis.com/", "schemas": { "AuditConfig": { @@ -1438,7 +1438,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/metastore/v1beta/metastore-gen.go b/metastore/v1beta/metastore-gen.go index 6b79e974357..65278ef4066 100644 --- a/metastore/v1beta/metastore-gen.go +++ b/metastore/v1beta/metastore-gen.go @@ -661,8 +661,7 @@ func (s *DataplexConfig) 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. diff --git a/mybusinessqanda/v1/mybusinessqanda-api.json b/mybusinessqanda/v1/mybusinessqanda-api.json index 6a22b1e7016..43b51a255b6 100644 --- a/mybusinessqanda/v1/mybusinessqanda-api.json +++ b/mybusinessqanda/v1/mybusinessqanda-api.json @@ -147,28 +147,6 @@ "$ref": "Empty" } }, - "deleteAnswers": { - "description": "Deletes the answer written by the current user to a question.", - "flatPath": "v1/locations/{locationsId}/questions/{questionsId}/answers", - "httpMethod": "DELETE", - "id": "mybusinessqanda.locations.questions.deleteAnswers", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Required. The name of the question to delete an answer for.", - "location": "path", - "pattern": "^locations/[^/]+/questions/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1/{+name}/answers", - "response": { - "$ref": "Empty" - } - }, "list": { "description": "Returns the paginated list of questions and some of its answers for a specified location. This operation is only valid if the specified location is verified.", "flatPath": "v1/locations/{locationsId}/questions", @@ -253,6 +231,28 @@ "resources": { "answers": { "methods": { + "delete": { + "description": "Deletes the answer written by the current user to a question.", + "flatPath": "v1/locations/{locationsId}/questions/{questionsId}/answers:delete", + "httpMethod": "DELETE", + "id": "mybusinessqanda.locations.questions.answers.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the question to delete an answer for.", + "location": "path", + "pattern": "^locations/[^/]+/questions/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}/answers:delete", + "response": { + "$ref": "Empty" + } + }, "list": { "description": "Returns the paginated list of answers for a specified question.", "flatPath": "v1/locations/{locationsId}/questions/{questionsId}/answers", @@ -281,12 +281,12 @@ "parent": { "description": "Required. The name of the question to fetch answers for.", "location": "path", - "pattern": "^locations/[^/]+/questions/[^/]+/answers$", + "pattern": "^locations/[^/]+/questions/[^/]+$", "required": true, "type": "string" } }, - "path": "v1/{+parent}", + "path": "v1/{+parent}/answers", "response": { "$ref": "ListAnswersResponse" } @@ -323,7 +323,7 @@ } } }, - "revision": "20220322", + "revision": "20220407", "rootUrl": "https://mybusinessqanda.googleapis.com/", "schemas": { "Answer": { diff --git a/mybusinessqanda/v1/mybusinessqanda-gen.go b/mybusinessqanda/v1/mybusinessqanda-gen.go index e344677b461..204c950cedd 100644 --- a/mybusinessqanda/v1/mybusinessqanda-gen.go +++ b/mybusinessqanda/v1/mybusinessqanda-gen.go @@ -706,136 +706,6 @@ func (c *LocationsQuestionsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, } -// method id "mybusinessqanda.locations.questions.deleteAnswers": - -type LocationsQuestionsDeleteAnswersCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// DeleteAnswers: Deletes the answer written by the current user to a -// question. -// -// - name: The name of the question to delete an answer for. -func (r *LocationsQuestionsService) DeleteAnswers(name string) *LocationsQuestionsDeleteAnswersCall { - c := &LocationsQuestionsDeleteAnswersCall{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 *LocationsQuestionsDeleteAnswersCall) Fields(s ...googleapi.Field) *LocationsQuestionsDeleteAnswersCall { - 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 *LocationsQuestionsDeleteAnswersCall) Context(ctx context.Context) *LocationsQuestionsDeleteAnswersCall { - 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 *LocationsQuestionsDeleteAnswersCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *LocationsQuestionsDeleteAnswersCall) 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, "v1/{+name}/answers") - 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 "mybusinessqanda.locations.questions.deleteAnswers" call. -// Exactly one of *Empty or error will be non-nil. Any non-2xx status -// code is an error. Response headers are in either -// *Empty.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 *LocationsQuestionsDeleteAnswersCall) Do(opts ...googleapi.CallOption) (*Empty, 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 := &Empty{ - 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 the answer written by the current user to a question.", - // "flatPath": "v1/locations/{locationsId}/questions/{questionsId}/answers", - // "httpMethod": "DELETE", - // "id": "mybusinessqanda.locations.questions.deleteAnswers", - // "parameterOrder": [ - // "name" - // ], - // "parameters": { - // "name": { - // "description": "Required. The name of the question to delete an answer for.", - // "location": "path", - // "pattern": "^locations/[^/]+/questions/[^/]+$", - // "required": true, - // "type": "string" - // } - // }, - // "path": "v1/{+name}/answers", - // "response": { - // "$ref": "Empty" - // } - // } - -} - // method id "mybusinessqanda.locations.questions.list": type LocationsQuestionsListCall struct { @@ -1223,6 +1093,135 @@ func (c *LocationsQuestionsPatchCall) Do(opts ...googleapi.CallOption) (*Questio } +// method id "mybusinessqanda.locations.questions.answers.delete": + +type LocationsQuestionsAnswersDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes the answer written by the current user to a question. +// +// - name: The name of the question to delete an answer for. +func (r *LocationsQuestionsAnswersService) Delete(name string) *LocationsQuestionsAnswersDeleteCall { + c := &LocationsQuestionsAnswersDeleteCall{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 *LocationsQuestionsAnswersDeleteCall) Fields(s ...googleapi.Field) *LocationsQuestionsAnswersDeleteCall { + 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 *LocationsQuestionsAnswersDeleteCall) Context(ctx context.Context) *LocationsQuestionsAnswersDeleteCall { + 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 *LocationsQuestionsAnswersDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *LocationsQuestionsAnswersDeleteCall) 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, "v1/{+name}/answers:delete") + 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 "mybusinessqanda.locations.questions.answers.delete" call. +// Exactly one of *Empty or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Empty.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 *LocationsQuestionsAnswersDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, 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 := &Empty{ + 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 the answer written by the current user to a question.", + // "flatPath": "v1/locations/{locationsId}/questions/{questionsId}/answers:delete", + // "httpMethod": "DELETE", + // "id": "mybusinessqanda.locations.questions.answers.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. The name of the question to delete an answer for.", + // "location": "path", + // "pattern": "^locations/[^/]+/questions/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}/answers:delete", + // "response": { + // "$ref": "Empty" + // } + // } + +} + // method id "mybusinessqanda.locations.questions.answers.list": type LocationsQuestionsAnswersListCall struct { @@ -1315,7 +1314,7 @@ func (c *LocationsQuestionsAnswersListCall) doRequest(alt string) (*http.Respons var body io.Reader = nil c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") - urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/answers") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { @@ -1393,12 +1392,12 @@ func (c *LocationsQuestionsAnswersListCall) Do(opts ...googleapi.CallOption) (*L // "parent": { // "description": "Required. The name of the question to fetch answers for.", // "location": "path", - // "pattern": "^locations/[^/]+/questions/[^/]+/answers$", + // "pattern": "^locations/[^/]+/questions/[^/]+$", // "required": true, // "type": "string" // } // }, - // "path": "v1/{+parent}", + // "path": "v1/{+parent}/answers", // "response": { // "$ref": "ListAnswersResponse" // } diff --git a/networkservices/v1beta1/networkservices-api.json b/networkservices/v1beta1/networkservices-api.json index aafb78b7835..a70fd30aeb9 100644 --- a/networkservices/v1beta1/networkservices-api.json +++ b/networkservices/v1beta1/networkservices-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" }, @@ -1498,40 +1498,6 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, - "patch": { - "description": "Updates the parameters of a single ServiceBinding.", - "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/serviceBindings/{serviceBindingsId}", - "httpMethod": "PATCH", - "id": "networkservices.projects.locations.serviceBindings.patch", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Required. Name of the ServiceBinding resource. It matches pattern `projects/*/locations/global/serviceBindings/service_binding_name\u003e`.", - "location": "path", - "pattern": "^projects/[^/]+/locations/[^/]+/serviceBindings/[^/]+$", - "required": true, - "type": "string" - }, - "updateMask": { - "description": "Optional. Field mask is used to specify the fields to be overwritten in the ServiceBinding resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", - "format": "google-fieldmask", - "location": "query", - "type": "string" - } - }, - "path": "v1beta1/{+name}", - "request": { - "$ref": "ServiceBinding" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform" - ] - }, "setIamPolicy": { "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/serviceBindings/{serviceBindingsId}:setIamPolicy", @@ -1909,7 +1875,7 @@ } } }, - "revision": "20220309", + "revision": "20220404", "rootUrl": "https://networkservices.googleapis.com/", "schemas": { "AuditConfig": { @@ -1969,7 +1935,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" }, @@ -1989,7 +1955,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" @@ -3367,10 +3333,6 @@ "description": "Optional. A free-text description of the resource. Max length 1024 characters.", "type": "string" }, - "endpointFilter": { - "description": "Optional. The endpoint filter associated with the Service Binding. The syntax is described in http://cloud/service-directory/docs/reference/rpc/google.cloud.servicedirectory.v1#google.cloud.servicedirectory.v1.ResolveServiceRequest", - "type": "string" - }, "labels": { "additionalProperties": { "type": "string" @@ -3401,7 +3363,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\"`", @@ -3570,7 +3532,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" }, @@ -3677,7 +3639,7 @@ "type": "object" }, "TlsRouteRouteMatch": { - "description": "RouteMatch defines the predicate used to match requests to a given action. Multiple match types are “AND”ed for evaluation. If no routeMatch field is specified, this rule will unconditionally match traffic.", + "description": "RouteMatch defines the predicate used to match requests to a given action. Multiple match types are \"AND\"ed for evaluation. If no routeMatch field is specified, this rule will unconditionally match traffic.", "id": "TlsRouteRouteMatch", "properties": { "alpn": { @@ -3706,7 +3668,7 @@ "description": "Required. The detailed rule defining how to route matched traffic." }, "matches": { - "description": "Required. RouteMatch defines the predicate used to match requests to a given action. Multiple match types are “OR”ed for evaluation.", + "description": "Required. RouteMatch defines the predicate used to match requests to a given action. Multiple match types are \"OR\"ed for evaluation.", "items": { "$ref": "TlsRouteRouteMatch" }, diff --git a/networkservices/v1beta1/networkservices-gen.go b/networkservices/v1beta1/networkservices-gen.go index 672683e6e56..8b80e26e447 100644 --- a/networkservices/v1beta1/networkservices-gen.go +++ b/networkservices/v1beta1/networkservices-gen.go @@ -375,8 +375,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 @@ -445,8 +445,7 @@ type CancelOperationRequest struct { // 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. @@ -2869,11 +2868,6 @@ type ServiceBinding struct { // length 1024 characters. Description string `json:"description,omitempty"` - // EndpointFilter: Optional. The endpoint filter associated with the - // Service Binding. The syntax is described in - // http://cloud/service-directory/docs/reference/rpc/google.cloud.servicedirectory.v1#google.cloud.servicedirectory.v1.ResolveServiceRequest - EndpointFilter string `json:"endpointFilter,omitempty"` - // Labels: Optional. Set of label tags associated with the // ServiceBinding resource. Labels map[string]string `json:"labels,omitempty"` @@ -2921,7 +2915,7 @@ func (s *ServiceBinding) 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"` @@ -3224,7 +3218,7 @@ func (s *TcpRouteRouteRule) 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"` @@ -3418,7 +3412,7 @@ func (s *TlsRouteRouteDestination) MarshalJSON() ([]byte, error) { } // TlsRouteRouteMatch: RouteMatch defines the predicate used to match -// requests to a given action. Multiple match types are “AND”ed for +// requests to a given action. Multiple match types are "AND"ed for // evaluation. If no routeMatch field is specified, this rule will // unconditionally match traffic. type TlsRouteRouteMatch struct { @@ -3466,7 +3460,7 @@ type TlsRouteRouteRule struct { Action *TlsRouteRouteAction `json:"action,omitempty"` // Matches: Required. RouteMatch defines the predicate used to match - // requests to a given action. Multiple match types are “OR”ed for + // requests to a given action. Multiple match types are "OR"ed for // evaluation. Matches []*TlsRouteRouteMatch `json:"matches,omitempty"` @@ -3694,8 +3688,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 @@ -3824,7 +3818,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" // }, @@ -10691,166 +10685,6 @@ func (c *ProjectsLocationsServiceBindingsListCall) Pages(ctx context.Context, f } } -// method id "networkservices.projects.locations.serviceBindings.patch": - -type ProjectsLocationsServiceBindingsPatchCall struct { - s *Service - name string - servicebinding *ServiceBinding - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Patch: Updates the parameters of a single ServiceBinding. -// -// - name: Name of the ServiceBinding resource. It matches pattern -// `projects/*/locations/global/serviceBindings/service_binding_name>`. -func (r *ProjectsLocationsServiceBindingsService) Patch(name string, servicebinding *ServiceBinding) *ProjectsLocationsServiceBindingsPatchCall { - c := &ProjectsLocationsServiceBindingsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.servicebinding = servicebinding - return c -} - -// UpdateMask sets the optional parameter "updateMask": Field mask is -// used to specify the fields to be overwritten in the ServiceBinding -// resource by the update. The fields specified in the update_mask are -// relative to the resource, not the full request. A field will be -// overwritten if it is in the mask. If the user does not provide a mask -// then all fields will be overwritten. -func (c *ProjectsLocationsServiceBindingsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsServiceBindingsPatchCall { - c.urlParams_.Set("updateMask", updateMask) - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse -// for more information. -func (c *ProjectsLocationsServiceBindingsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsServiceBindingsPatchCall { - 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 *ProjectsLocationsServiceBindingsPatchCall) Context(ctx context.Context) *ProjectsLocationsServiceBindingsPatchCall { - 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 *ProjectsLocationsServiceBindingsPatchCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsLocationsServiceBindingsPatchCall) 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.servicebinding) - 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, "v1beta1/{+name}") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "name": c.name, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "networkservices.projects.locations.serviceBindings.patch" call. -// Exactly one of *Operation or error will be non-nil. Any non-2xx -// status code is an error. Response headers are in either -// *Operation.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 *ProjectsLocationsServiceBindingsPatchCall) Do(opts ...googleapi.CallOption) (*Operation, 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 := &Operation{ - 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 parameters of a single ServiceBinding.", - // "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/serviceBindings/{serviceBindingsId}", - // "httpMethod": "PATCH", - // "id": "networkservices.projects.locations.serviceBindings.patch", - // "parameterOrder": [ - // "name" - // ], - // "parameters": { - // "name": { - // "description": "Required. Name of the ServiceBinding resource. It matches pattern `projects/*/locations/global/serviceBindings/service_binding_name\u003e`.", - // "location": "path", - // "pattern": "^projects/[^/]+/locations/[^/]+/serviceBindings/[^/]+$", - // "required": true, - // "type": "string" - // }, - // "updateMask": { - // "description": "Optional. Field mask is used to specify the fields to be overwritten in the ServiceBinding resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", - // "format": "google-fieldmask", - // "location": "query", - // "type": "string" - // } - // }, - // "path": "v1beta1/{+name}", - // "request": { - // "$ref": "ServiceBinding" - // }, - // "response": { - // "$ref": "Operation" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform" - // ] - // } - -} - // method id "networkservices.projects.locations.serviceBindings.setIamPolicy": type ProjectsLocationsServiceBindingsSetIamPolicyCall struct { diff --git a/servicenetworking/v1beta/servicenetworking-api.json b/servicenetworking/v1beta/servicenetworking-api.json index cdc7f4878af..231593b63d7 100644 --- a/servicenetworking/v1beta/servicenetworking-api.json +++ b/servicenetworking/v1beta/servicenetworking-api.json @@ -307,7 +307,7 @@ } } }, - "revision": "20220129", + "revision": "20220406", "rootUrl": "https://servicenetworking.googleapis.com/", "schemas": { "AddDnsRecordSetMetadata": { @@ -477,7 +477,7 @@ "type": "string" }, "jwtLocations": { - "description": "Defines the locations to extract the JWT. JWT locations can be either from HTTP headers or URL query parameters. The rule is that the first match wins. The checking order is: checking all headers first, then URL query parameters. If not specified, default to use following 3 locations: 1) Authorization: Bearer 2) x-goog-iap-jwt-assertion 3) access_token query parameter Default locations can be specified as followings: jwt_locations: - header: Authorization value_prefix: \"Bearer \" - header: x-goog-iap-jwt-assertion - query: access_token", + "description": "Defines the locations to extract the JWT. For now it is only used by the Cloud Endpoints to store the OpenAPI extension [x-google-jwt-locations] (https://cloud.google.com/endpoints/docs/openapi/openapi-extensions#x-google-jwt-locations) JWT locations can be one of HTTP headers, URL query parameters or cookies. The rule is that the first match wins. If not specified, default to use following 3 locations: 1) Authorization: Bearer 2) x-goog-iap-jwt-assertion 3) access_token query parameter Default locations can be specified as followings: jwt_locations: - header: Authorization value_prefix: \"Bearer \" - header: x-goog-iap-jwt-assertion - query: access_token", "items": { "$ref": "JwtLocation" }, @@ -1290,6 +1290,10 @@ "description": "Specifies a location to extract JWT from an API request.", "id": "JwtLocation", "properties": { + "cookie": { + "description": "Specifies cookie name to extract JWT token.", + "type": "string" + }, "header": { "description": "Specifies HTTP header name to extract JWT token.", "type": "string" diff --git a/servicenetworking/v1beta/servicenetworking-gen.go b/servicenetworking/v1beta/servicenetworking-gen.go index 18d95ab4879..e3468953b84 100644 --- a/servicenetworking/v1beta/servicenetworking-gen.go +++ b/servicenetworking/v1beta/servicenetworking-gen.go @@ -451,11 +451,13 @@ type AuthProvider struct { // https://www.googleapis.com/oauth2/v1/certs JwksUri string `json:"jwksUri,omitempty"` - // JwtLocations: Defines the locations to extract the JWT. JWT locations - // can be either from HTTP headers or URL query parameters. The rule is - // that the first match wins. The checking order is: checking all - // headers first, then URL query parameters. If not specified, default - // to use following 3 locations: 1) Authorization: Bearer 2) + // JwtLocations: Defines the locations to extract the JWT. For now it is + // only used by the Cloud Endpoints to store the OpenAPI extension + // [x-google-jwt-locations] + // (https://cloud.google.com/endpoints/docs/openapi/openapi-extensions#x-google-jwt-locations) + // JWT locations can be one of HTTP headers, URL query parameters or + // cookies. The rule is that the first match wins. If not specified, + // default to use following 3 locations: 1) Authorization: Bearer 2) // x-goog-iap-jwt-assertion 3) access_token query parameter Default // locations can be specified as followings: jwt_locations: - header: // Authorization value_prefix: "Bearer " - header: @@ -2059,6 +2061,9 @@ func (s *HttpRule) MarshalJSON() ([]byte, error) { // JwtLocation: Specifies a location to extract JWT from an API request. type JwtLocation struct { + // Cookie: Specifies cookie name to extract JWT token. + Cookie string `json:"cookie,omitempty"` + // Header: Specifies HTTP header name to extract JWT token. Header string `json:"header,omitempty"` @@ -2074,7 +2079,7 @@ type JwtLocation struct { // value_prefix="Bearer " with a space at the end. ValuePrefix string `json:"valuePrefix,omitempty"` - // ForceSendFields is a list of field names (e.g. "Header") to + // ForceSendFields is a list of field names (e.g. "Cookie") 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 @@ -2082,7 +2087,7 @@ type JwtLocation struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Header") to include in API + // NullFields is a list of field names (e.g. "Cookie") 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 From f39fdccf5f5d30e16b8dce8dadc7cff8b4b075a7 Mon Sep 17 00:00:00 2001 From: WhiteSource Renovate Date: Mon, 11 Apr 2022 22:02:05 +0200 Subject: [PATCH 08/17] chore(all): update all to aac1ed4 (#1507) --- go.mod | 8 ++++---- go.sum | 15 ++++++++------- 2 files changed, 12 insertions(+), 11 deletions(-) diff --git a/go.mod b/go.mod index 5a78fcb0076..276f23d8cf9 100644 --- a/go.mod +++ b/go.mod @@ -7,12 +7,12 @@ require ( github.com/google/go-cmp v0.5.7 github.com/googleapis/gax-go/v2 v2.2.0 go.opencensus.io v0.23.0 - golang.org/x/net v0.0.0-20220403103023-749bd193bc2b + golang.org/x/net v0.0.0-20220407224826-aac1ed45d8e3 golang.org/x/oauth2 v0.0.0-20220309155454-6242fa91716a golang.org/x/sync v0.0.0-20210220032951-036812b2e83c - golang.org/x/sys v0.0.0-20220403205710-6acee93ad0eb - golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1 + golang.org/x/sys v0.0.0-20220408201424-a24fb2fb8a0f + golang.org/x/xerrors v0.0.0-20220411182839-cd4e9df8ec86 google.golang.org/appengine v1.6.7 - google.golang.org/genproto v0.0.0-20220401170504-314d38edb7de + google.golang.org/genproto v0.0.0-20220407144326-9054f6ed7bac google.golang.org/grpc v1.45.0 ) diff --git a/go.sum b/go.sum index 75a4d5f720c..87431941aad 100644 --- a/go.sum +++ b/go.sum @@ -270,8 +270,8 @@ golang.org/x/net v0.0.0-20210405180319-a5a99cb37ef4/go.mod h1:p54w0d4576C0XHj96b golang.org/x/net v0.0.0-20210503060351-7fd8e65b6420/go.mod h1:9nx3DQGgdP8bBQD5qxJ1jj9UTztislL4KSBs9R2vV5Y= golang.org/x/net v0.0.0-20220127200216-cd36cc0744dd/go.mod h1:CfG3xpIq0wQ8r1q4Su4UZFWDARRcnwPjda9FqA0JpMk= golang.org/x/net v0.0.0-20220225172249-27dd8689420f/go.mod h1:CfG3xpIq0wQ8r1q4Su4UZFWDARRcnwPjda9FqA0JpMk= -golang.org/x/net v0.0.0-20220403103023-749bd193bc2b h1:vI32FkLJNAWtGD4BwkThwEy6XS7ZLLMHkSkYfF8M0W0= -golang.org/x/net v0.0.0-20220403103023-749bd193bc2b/go.mod h1:CfG3xpIq0wQ8r1q4Su4UZFWDARRcnwPjda9FqA0JpMk= +golang.org/x/net v0.0.0-20220407224826-aac1ed45d8e3 h1:EN5+DfgmRMvRUrMGERW2gQl3Vc+Z7ZMnI/xdEpPSf0c= +golang.org/x/net v0.0.0-20220407224826-aac1ed45d8e3/go.mod h1:CfG3xpIq0wQ8r1q4Su4UZFWDARRcnwPjda9FqA0JpMk= golang.org/x/oauth2 v0.0.0-20180821212333-d2e6202438be/go.mod h1:N/0e6XlmueqKjAGxoOufVs8QHGRruUQn6yWY3a++T0U= golang.org/x/oauth2 v0.0.0-20190226205417-e64efc72b421/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= golang.org/x/oauth2 v0.0.0-20190604053449-0f29369cfe45/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= @@ -355,8 +355,8 @@ golang.org/x/sys v0.0.0-20211216021012-1d35b9e2eb4e/go.mod h1:oPkhp1MJrh7nUepCBc golang.org/x/sys v0.0.0-20220128215802-99c3d69c2c27/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.0.0-20220209214540-3681064d5158/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.0.0-20220227234510-4e6760a101f9/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.0.0-20220403205710-6acee93ad0eb h1:PVGECzEo9Y3uOidtkHGdd347NjLtITfJFO9BxFpmRoo= -golang.org/x/sys v0.0.0-20220403205710-6acee93ad0eb/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.0.0-20220408201424-a24fb2fb8a0f h1:8w7RhxzTVgUzw/AH/9mUV5q0vMgy40SQRursCcfmkCw= +golang.org/x/sys v0.0.0-20220408201424-a24fb2fb8a0f/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo= golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= golang.org/x/text v0.0.0-20170915032832-14c0d48ead0c/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= @@ -426,8 +426,9 @@ golang.org/x/tools v0.1.5/go.mod h1:o0xws9oXOQQZyjljx8fwUC0k7L1pTE6eaCbjGeHmOkk= golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= golang.org/x/xerrors v0.0.0-20191011141410-1b5146add898/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= -golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1 h1:go1bK/D/BFZV2I8cIQd1NKEZ+0owSTG1fDTci4IqFcE= golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= +golang.org/x/xerrors v0.0.0-20220411182839-cd4e9df8ec86 h1:lX9l83i65uxQFfIS7nmg8tFhgtTdFVSTBmLv01vnMZY= +golang.org/x/xerrors v0.0.0-20220411182839-cd4e9df8ec86/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= google.golang.org/api v0.4.0/go.mod h1:8k5glujaEP+g9n7WNsDg8QP6cUVNI86fCNMcbazEtwE= google.golang.org/api v0.7.0/go.mod h1:WtwebWUNSVBH/HAw79HIFXZNqEvBhG+Ra+ax0hx3E3M= google.golang.org/api v0.8.0/go.mod h1:o4eAsZoiT+ibD93RtjEohWalFOjRDx6CVaqeizhEnKg= @@ -536,8 +537,8 @@ google.golang.org/genproto v0.0.0-20220218161850-94dd64e39d7c/go.mod h1:kGP+zUP2 google.golang.org/genproto v0.0.0-20220222213610-43724f9ea8cf/go.mod h1:kGP+zUP2Ddo0ayMi4YuN7C3WZyJvGLZRh8Z5wnAqvEI= google.golang.org/genproto v0.0.0-20220304144024-325a89244dc8/go.mod h1:kGP+zUP2Ddo0ayMi4YuN7C3WZyJvGLZRh8Z5wnAqvEI= google.golang.org/genproto v0.0.0-20220310185008-1973136f34c6/go.mod h1:kGP+zUP2Ddo0ayMi4YuN7C3WZyJvGLZRh8Z5wnAqvEI= -google.golang.org/genproto v0.0.0-20220401170504-314d38edb7de h1:9Ti5SG2U4cAcluryUo/sFay3TQKoxiFMfaT0pbizU7k= -google.golang.org/genproto v0.0.0-20220401170504-314d38edb7de/go.mod h1:8w6bsBMX6yCPbAVTeqQHvzxW0EIFigd5lZyahWgyfDo= +google.golang.org/genproto v0.0.0-20220407144326-9054f6ed7bac h1:qSNTkEN+L2mvWcLgJOR+8bdHX9rN/IdU3A1Ghpfb1Rg= +google.golang.org/genproto v0.0.0-20220407144326-9054f6ed7bac/go.mod h1:8w6bsBMX6yCPbAVTeqQHvzxW0EIFigd5lZyahWgyfDo= google.golang.org/grpc v1.19.0/go.mod h1:mqu4LbDTu4XGKhr4mRzUsmM4RtVoemTSY81AxZiDr8c= google.golang.org/grpc v1.20.1/go.mod h1:10oTOabMzJvdu6/UiuZezV6QK5dSlG84ov/aaiqXj38= google.golang.org/grpc v1.21.1/go.mod h1:oYelfM1adQP15Ek0mdvEgi9Df8B9CZIaU1084ijfRaM= From d0006d4605847d9f8ce114bf76edb5a256a9eb5e Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Tue, 12 Apr 2022 07:20:02 -0700 Subject: [PATCH 09/17] feat(all): auto-regenerate discovery clients (#1509) --- .../v1/androidenterprise-api.json | 20 +- androidenterprise/v1/androidenterprise-gen.go | 38 + api-list.json | 17 +- apigateway/v1beta/apigateway-api.json | 10 +- apigateway/v1beta/apigateway-gen.go | 14 +- bigquery/v2/bigquery-api.json | 52 +- bigquery/v2/bigquery-gen.go | 72 +- cloudsearch/v1/cloudsearch-api.json | 10 +- cloudsearch/v1/cloudsearch-gen.go | 4 +- cloudtasks/v2/cloudtasks-api.json | 4 +- cloudtasks/v2/cloudtasks-gen.go | 6 +- cloudtasks/v2beta2/cloudtasks-api.json | 4 +- cloudtasks/v2beta2/cloudtasks-gen.go | 6 +- cloudtasks/v2beta3/cloudtasks-api.json | 4 +- cloudtasks/v2beta3/cloudtasks-gen.go | 6 +- dlp/v2/dlp-api.json | 480 +- dlp/v2/dlp-gen.go | 711 +- eventarc/v1beta1/eventarc-api.json | 10 +- eventarc/v1beta1/eventarc-gen.go | 14 +- file/v1beta1/file-api.json | 36 +- file/v1beta1/file-gen.go | 76 +- gkebackup/v1/gkebackup-api.json | 3080 +++++ gkebackup/v1/gkebackup-gen.go | 10435 ++++++++++++++++ gkehub/v1/gkehub-api.json | 104 +- gkehub/v1/gkehub-gen.go | 169 +- gkehub/v1beta/gkehub-api.json | 6 +- gkehub/v1beta/gkehub-gen.go | 10 +- gkehub/v1beta1/gkehub-api.json | 4 +- gkehub/v1beta1/gkehub-gen.go | 6 +- lifesciences/v2beta/lifesciences-api.json | 4 +- lifesciences/v2beta/lifesciences-gen.go | 6 +- memcache/v1/memcache-api.json | 20 +- memcache/v1/memcache-gen.go | 34 +- memcache/v1beta2/memcache-api.json | 20 +- memcache/v1beta2/memcache-gen.go | 34 +- metastore/v1alpha/metastore-api.json | 4 +- metastore/v1alpha/metastore-gen.go | 3 +- .../v1alpha1/networkconnectivity-api.json | 192 +- .../v1alpha1/networkconnectivity-gen.go | 976 +- networkservices/v1/networkservices-api.json | 12 +- networkservices/v1/networkservices-gen.go | 17 +- privateca/v1beta1/privateca-api.json | 10 +- privateca/v1beta1/privateca-gen.go | 14 +- runtimeconfig/v1beta1/runtimeconfig-api.json | 8 +- runtimeconfig/v1beta1/runtimeconfig-gen.go | 8 +- .../v1/servicenetworking-api.json | 8 +- servicenetworking/v1/servicenetworking-gen.go | 19 +- vmmigration/v1/vmmigration-api.json | 4 +- vmmigration/v1/vmmigration-gen.go | 6 +- vmmigration/v1alpha1/vmmigration-api.json | 4 +- vmmigration/v1alpha1/vmmigration-gen.go | 6 +- youtube/v3/youtube-api.json | 4 +- youtube/v3/youtube-gen.go | 1 + 53 files changed, 16602 insertions(+), 220 deletions(-) create mode 100644 gkebackup/v1/gkebackup-api.json create mode 100644 gkebackup/v1/gkebackup-gen.go diff --git a/androidenterprise/v1/androidenterprise-api.json b/androidenterprise/v1/androidenterprise-api.json index 036ad2fd5a0..a4929084112 100644 --- a/androidenterprise/v1/androidenterprise-api.json +++ b/androidenterprise/v1/androidenterprise-api.json @@ -2610,7 +2610,7 @@ } } }, - "revision": "20210723", + "revision": "20220407", "rootUrl": "https://androidenterprise.googleapis.com/", "schemas": { "Administrator": { @@ -3241,6 +3241,17 @@ }, "type": "object" }, + "EnterpriseAuthenticationAppLinkConfig": { + "description": "An authentication URL configuration for the authenticator app of an identity provider.", + "id": "EnterpriseAuthenticationAppLinkConfig", + "properties": { + "uri": { + "description": "An authentication url.", + "type": "string" + } + }, + "type": "object" + }, "EnterprisesListResponse": { "id": "EnterprisesListResponse", "properties": { @@ -4232,6 +4243,13 @@ ], "type": "string" }, + "enterpriseAuthenticationAppLinkConfigs": { + "description": "An authentication URL configuration for the authenticator app of an identity provider. This helps to launch the identity provider's authenticator app during the authentication happening in a private app using Android WebView. Authenticator app should already be the [default handler](https://developer.android.com/training/app-links/verify-site-associations) for the authentication url on the device.", + "items": { + "$ref": "EnterpriseAuthenticationAppLinkConfig" + }, + "type": "array" + }, "managedConfiguration": { "$ref": "ManagedConfiguration", "description": "The managed configuration for the product." diff --git a/androidenterprise/v1/androidenterprise-gen.go b/androidenterprise/v1/androidenterprise-gen.go index b344f4664f3..3d86b791356 100644 --- a/androidenterprise/v1/androidenterprise-gen.go +++ b/androidenterprise/v1/androidenterprise-gen.go @@ -1434,6 +1434,35 @@ func (s *EnterpriseAccount) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// EnterpriseAuthenticationAppLinkConfig: An authentication URL +// configuration for the authenticator app of an identity provider. +type EnterpriseAuthenticationAppLinkConfig struct { + // Uri: An authentication url. + Uri string `json:"uri,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Uri") 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. "Uri") 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 *EnterpriseAuthenticationAppLinkConfig) MarshalJSON() ([]byte, error) { + type NoMethod EnterpriseAuthenticationAppLinkConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + type EnterprisesListResponse struct { // Enterprise: An enterprise. Enterprise []*Enterprise `json:"enterprise,omitempty"` @@ -3027,6 +3056,15 @@ type ProductPolicy struct { // a new app update after it is published by the developer. AutoUpdateMode string `json:"autoUpdateMode,omitempty"` + // EnterpriseAuthenticationAppLinkConfigs: An authentication URL + // configuration for the authenticator app of an identity provider. This + // helps to launch the identity provider's authenticator app during the + // authentication happening in a private app using Android WebView. + // Authenticator app should already be the default handler + // (https://developer.android.com/training/app-links/verify-site-associations) + // for the authentication url on the device. + EnterpriseAuthenticationAppLinkConfigs []*EnterpriseAuthenticationAppLinkConfig `json:"enterpriseAuthenticationAppLinkConfigs,omitempty"` + // ManagedConfiguration: The managed configuration for the product. ManagedConfiguration *ManagedConfiguration `json:"managedConfiguration,omitempty"` diff --git a/api-list.json b/api-list.json index f7da025b27f..8f163d55730 100644 --- a/api-list.json +++ b/api-list.json @@ -284,7 +284,7 @@ "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/analytics-hub/", + "documentationLink": "https://cloud.google.com/bigquery/docs/analytics-hub-introduction", "preferred": true }, { @@ -2811,6 +2811,21 @@ "documentationLink": "https://cloud.google.com/genomics", "preferred": true }, + { + "kind": "discovery#directoryItem", + "id": "gkebackup:v1", + "name": "gkebackup", + "version": "v1", + "title": "Backup for GKE API", + "description": "Backup for GKE is a managed Kubernetes workload backup and restore service for GKE clusters.", + "discoveryRestUrl": "https://gkebackup.googleapis.com/$discovery/rest?version=v1", + "icons": { + "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", + "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" + }, + "documentationLink": "https://cloud.google.com/kubernetes-engine/docs/add-on/backup-for-gke", + "preferred": true + }, { "kind": "discovery#directoryItem", "id": "gkehub:v1alpha", diff --git a/apigateway/v1beta/apigateway-api.json b/apigateway/v1beta/apigateway-api.json index d294057fda2..a28e49966c6 100644 --- a/apigateway/v1beta/apigateway-api.json +++ b/apigateway/v1beta/apigateway-api.json @@ -143,7 +143,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" }, @@ -1083,7 +1083,7 @@ } } }, - "revision": "20220323", + "revision": "20220406", "rootUrl": "https://apigateway.googleapis.com/", "schemas": { "ApigatewayApi": { @@ -1351,7 +1351,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" }, @@ -1753,7 +1753,7 @@ "properties": { "policy": { "$ref": "ApigatewayPolicy", - "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\"`", @@ -1795,7 +1795,7 @@ "id": "ApigatewayTestIamPermissionsRequest", "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/apigateway/v1beta/apigateway-gen.go b/apigateway/v1beta/apigateway-gen.go index 66fbaf9db25..c87f52d1aa9 100644 --- a/apigateway/v1beta/apigateway-gen.go +++ b/apigateway/v1beta/apigateway-gen.go @@ -622,8 +622,8 @@ type ApigatewayBinding struct { // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *ApigatewayExpr `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 @@ -1354,7 +1354,7 @@ func (s *ApigatewayPolicy) MarshalJSON() ([]byte, error) { type ApigatewaySetIamPolicyRequest 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 *ApigatewayPolicy `json:"policy,omitempty"` @@ -1435,7 +1435,7 @@ func (s *ApigatewayStatus) MarshalJSON() ([]byte, error) { // `TestIamPermissions` method. type ApigatewayTestIamPermissionsRequest 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"` @@ -1678,8 +1678,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 @@ -1808,7 +1808,7 @@ func (c *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*Apigatewa // ], // "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/bigquery/v2/bigquery-api.json b/bigquery/v2/bigquery-api.json index e5765123bc7..c8016ddb4fc 100644 --- a/bigquery/v2/bigquery-api.json +++ b/bigquery/v2/bigquery-api.json @@ -1693,7 +1693,7 @@ } } }, - "revision": "20220322", + "revision": "20220326", "rootUrl": "https://bigquery.googleapis.com/", "schemas": { "AggregateClassificationMetrics": { @@ -3323,7 +3323,7 @@ "type": "number" }, "featureName": { - "description": "Full name of the feature. For non-numerical features, will be formatted like .. Overall size of feature name will always be truncated to first 120 characters.", + "description": "The full feature name. For non-numerical features, will be formatted like `.`. Overall size of feature name will always be truncated to first 120 characters.", "type": "string" } }, @@ -3694,7 +3694,7 @@ "type": "object" }, "HparamTuningTrial": { - "description": "Training info of a trial in hyperparameter tuning.", + "description": "Training info of a trial in [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.", "id": "HparamTuningTrial", "properties": { "endTimeMs": { @@ -4910,7 +4910,7 @@ "type": "string" }, "defaultTrialId": { - "description": "Output only. The default trial_id to use in TVFs when the trial_id is not passed in. For single-objective hyperparameter tuning, this is the best trial id. For multi-objective hyperparameter tuning, this is the smallest trial id among all Pareto optimal trials.", + "description": "Output only. The default trial_id to use in TVFs when the trial_id is not passed in. For single-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the best trial ID. For multi-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the smallest trial ID among all Pareto optimal trials.", "format": "int64", "readOnly": true, "type": "string" @@ -4951,7 +4951,7 @@ "readOnly": true }, "hparamTrials": { - "description": "Output only. Trials of a hyperparameter tuning model sorted by trial_id.", + "description": "Output only. Trials of a [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) model sorted by trial_id.", "items": { "$ref": "HparamTuningTrial" }, @@ -5030,7 +5030,7 @@ "type": "string" }, "optimalTrialIds": { - "description": "Output only. For single-objective hyperparameter tuning, it only contains the best trial. For multi-objective hyperparameter tuning, it contains all Pareto optimal trials sorted by trial_id.", + "description": "Output only. For single-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it only contains the best trial. For multi-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it contains all Pareto optimal trials sorted by trial_id.", "items": { "format": "int64", "type": "string" @@ -6142,6 +6142,46 @@ "format": "uint64", "type": "string" }, + "num_active_logical_bytes": { + "description": "[Output-only] Number of logical bytes that are less than 90 days old.", + "format": "int64", + "type": "string" + }, + "num_active_physical_bytes": { + "description": "[Output-only] Number of physical bytes less than 90 days old. This data is not kept in real time, and might be delayed by a few seconds to a few minutes.", + "format": "int64", + "type": "string" + }, + "num_long_term_logical_bytes": { + "description": "[Output-only] Number of logical bytes that are more than 90 days old.", + "format": "int64", + "type": "string" + }, + "num_long_term_physical_bytes": { + "description": "[Output-only] Number of physical bytes more than 90 days old. This data is not kept in real time, and might be delayed by a few seconds to a few minutes.", + "format": "int64", + "type": "string" + }, + "num_partitions": { + "description": "[Output-only] The number of partitions present in the table or materialized view. This data is not kept in real time, and might be delayed by a few seconds to a few minutes.", + "format": "int64", + "type": "string" + }, + "num_time_travel_physical_bytes": { + "description": "[Output-only] Number of physical bytes used by time travel storage (deleted or changed data). This data is not kept in real time, and might be delayed by a few seconds to a few minutes.", + "format": "int64", + "type": "string" + }, + "num_total_logical_bytes": { + "description": "[Output-only] Total number of logical bytes in the table or materialized view.", + "format": "int64", + "type": "string" + }, + "num_total_physical_bytes": { + "description": "[Output-only] The physical size of this table in bytes. This also includes storage used for time travel. This data is not kept in real time, and might be delayed by a few seconds to a few minutes.", + "format": "int64", + "type": "string" + }, "rangePartitioning": { "$ref": "RangePartitioning", "description": "[TrustedTester] Range partitioning specification for this table. Only one of timePartitioning and rangePartitioning should be specified." diff --git a/bigquery/v2/bigquery-gen.go b/bigquery/v2/bigquery-gen.go index 8b8a650133e..c1d347cb253 100644 --- a/bigquery/v2/bigquery-gen.go +++ b/bigquery/v2/bigquery-gen.go @@ -3024,8 +3024,8 @@ type Explanation struct { // Attribution: Attribution of feature. Attribution float64 `json:"attribution,omitempty"` - // FeatureName: Full name of the feature. For non-numerical features, - // will be formatted like .. Overall size of feature name will always be + // FeatureName: The full feature name. For non-numerical features, will + // be formatted like `.`. Overall size of feature name will always be // truncated to first 120 characters. FeatureName string `json:"featureName,omitempty"` @@ -3727,7 +3727,9 @@ func (s *HparamSearchSpaces) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// HparamTuningTrial: Training info of a trial in hyperparameter tuning. +// HparamTuningTrial: Training info of a trial in hyperparameter tuning +// (/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning- +// overview) models. type HparamTuningTrial struct { // EndTimeMs: Ending time of the trial. EndTimeMs int64 `json:"endTimeMs,omitempty,string"` @@ -5591,9 +5593,13 @@ type Model struct { // DefaultTrialId: Output only. The default trial_id to use in TVFs when // the trial_id is not passed in. For single-objective hyperparameter - // tuning, this is the best trial id. For multi-objective hyperparameter - // tuning, this is the smallest trial id among all Pareto optimal - // trials. + // tuning + // (/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning- + // overview) models, this is the best trial ID. For multi-objective + // hyperparameter tuning + // (/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning- + // overview) models, this is the smallest trial ID among all Pareto + // optimal trials. DefaultTrialId int64 `json:"defaultTrialId,omitempty,string"` // Description: Optional. A user-friendly description of this model. @@ -5627,8 +5633,9 @@ type Model struct { // this model. HparamSearchSpaces *HparamSearchSpaces `json:"hparamSearchSpaces,omitempty"` - // HparamTrials: Output only. Trials of a hyperparameter tuning model - // sorted by trial_id. + // HparamTrials: Output only. Trials of a hyperparameter tuning + // (/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning- + // overview) model sorted by trial_id. HparamTrials []*HparamTuningTrial `json:"hparamTrials,omitempty"` // LabelColumns: Output only. Label columns that were used to train this @@ -5678,9 +5685,13 @@ type Model struct { ModelType string `json:"modelType,omitempty"` // OptimalTrialIds: Output only. For single-objective hyperparameter - // tuning, it only contains the best trial. For multi-objective - // hyperparameter tuning, it contains all Pareto optimal trials sorted - // by trial_id. + // tuning + // (/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning- + // overview) models, it only contains the best trial. For + // multi-objective hyperparameter tuning + // (/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning- + // overview) models, it contains all Pareto optimal trials sorted by + // trial_id. OptimalTrialIds googleapi.Int64s `json:"optimalTrialIds,omitempty"` // TrainingRuns: Output only. Information for all training runs in @@ -7589,6 +7600,45 @@ type Table struct { // excluding any data in the streaming buffer. NumRows uint64 `json:"numRows,omitempty,string"` + // NumActiveLogicalBytes: [Output-only] Number of logical bytes that are + // less than 90 days old. + NumActiveLogicalBytes int64 `json:"num_active_logical_bytes,omitempty,string"` + + // NumActivePhysicalBytes: [Output-only] Number of physical bytes less + // than 90 days old. This data is not kept in real time, and might be + // delayed by a few seconds to a few minutes. + NumActivePhysicalBytes int64 `json:"num_active_physical_bytes,omitempty,string"` + + // NumLongTermLogicalBytes: [Output-only] Number of logical bytes that + // are more than 90 days old. + NumLongTermLogicalBytes int64 `json:"num_long_term_logical_bytes,omitempty,string"` + + // NumLongTermPhysicalBytes: [Output-only] Number of physical bytes more + // than 90 days old. This data is not kept in real time, and might be + // delayed by a few seconds to a few minutes. + NumLongTermPhysicalBytes int64 `json:"num_long_term_physical_bytes,omitempty,string"` + + // NumPartitions: [Output-only] The number of partitions present in the + // table or materialized view. This data is not kept in real time, and + // might be delayed by a few seconds to a few minutes. + NumPartitions int64 `json:"num_partitions,omitempty,string"` + + // NumTimeTravelPhysicalBytes: [Output-only] Number of physical bytes + // used by time travel storage (deleted or changed data). This data is + // not kept in real time, and might be delayed by a few seconds to a few + // minutes. + NumTimeTravelPhysicalBytes int64 `json:"num_time_travel_physical_bytes,omitempty,string"` + + // NumTotalLogicalBytes: [Output-only] Total number of logical bytes in + // the table or materialized view. + NumTotalLogicalBytes int64 `json:"num_total_logical_bytes,omitempty,string"` + + // NumTotalPhysicalBytes: [Output-only] The physical size of this table + // in bytes. This also includes storage used for time travel. This data + // is not kept in real time, and might be delayed by a few seconds to a + // few minutes. + NumTotalPhysicalBytes int64 `json:"num_total_physical_bytes,omitempty,string"` + // RangePartitioning: [TrustedTester] Range partitioning specification // for this table. Only one of timePartitioning and rangePartitioning // should be specified. diff --git a/cloudsearch/v1/cloudsearch-api.json b/cloudsearch/v1/cloudsearch-api.json index a68665ed4a2..c1590ae7580 100644 --- a/cloudsearch/v1/cloudsearch-api.json +++ b/cloudsearch/v1/cloudsearch-api.json @@ -1994,7 +1994,7 @@ } } }, - "revision": "20220328", + "revision": "20220404", "rootUrl": "https://cloudsearch.googleapis.com/", "schemas": { "AclInfo": { @@ -2064,11 +2064,10 @@ "SHEETS_APP", "SLIDES_APP", "MEET_APP", - "FILE_SUGGESTION_APP", + "ASSISTIVE_SUGGESTION_APP", "CONTACTS_APP", "ACTIVITY_FEED_APP", - "DRIVE_APP", - "ASSISTIVE_SUGGESTION_APP" + "DRIVE_APP" ], "enumDescriptions": [ "", @@ -2081,8 +2080,7 @@ "Powered by Bullseye", "", "", - "", - "TODO (b/220205747): replace the above FILE_SUGGESTION_APP in the future." + "" ], "type": "string" }, diff --git a/cloudsearch/v1/cloudsearch-gen.go b/cloudsearch/v1/cloudsearch-gen.go index 2e03d3e0b97..9e25b00d0c5 100644 --- a/cloudsearch/v1/cloudsearch-gen.go +++ b/cloudsearch/v1/cloudsearch-gen.go @@ -575,12 +575,10 @@ type AppId struct { // "SHEETS_APP" // "SLIDES_APP" // "MEET_APP" - // "FILE_SUGGESTION_APP" - Powered by Bullseye + // "ASSISTIVE_SUGGESTION_APP" - Powered by Bullseye // "CONTACTS_APP" // "ACTIVITY_FEED_APP" // "DRIVE_APP" - // "ASSISTIVE_SUGGESTION_APP" - TODO (b/220205747): replace the above - // FILE_SUGGESTION_APP in the future. GsuiteAppType string `json:"gsuiteAppType,omitempty"` // Id: Numeric identifier of the App. Set to Project number for 1/3P diff --git a/cloudtasks/v2/cloudtasks-api.json b/cloudtasks/v2/cloudtasks-api.json index 1e0517b64cd..025e12bd807 100644 --- a/cloudtasks/v2/cloudtasks-api.json +++ b/cloudtasks/v2/cloudtasks-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" }, @@ -685,7 +685,7 @@ } } }, - "revision": "20220321", + "revision": "20220401", "rootUrl": "https://cloudtasks.googleapis.com/", "schemas": { "AppEngineHttpRequest": { diff --git a/cloudtasks/v2/cloudtasks-gen.go b/cloudtasks/v2/cloudtasks-gen.go index 1f44e1201a6..c6014378fc7 100644 --- a/cloudtasks/v2/cloudtasks-gen.go +++ b/cloudtasks/v2/cloudtasks-gen.go @@ -2005,8 +2005,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 @@ -2135,7 +2135,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/cloudtasks/v2beta2/cloudtasks-api.json b/cloudtasks/v2beta2/cloudtasks-api.json index 96295b0beea..88c165e5f22 100644 --- a/cloudtasks/v2beta2/cloudtasks-api.json +++ b/cloudtasks/v2beta2/cloudtasks-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" }, @@ -809,7 +809,7 @@ } } }, - "revision": "20220321", + "revision": "20220401", "rootUrl": "https://cloudtasks.googleapis.com/", "schemas": { "AcknowledgeTaskRequest": { diff --git a/cloudtasks/v2beta2/cloudtasks-gen.go b/cloudtasks/v2beta2/cloudtasks-gen.go index 5c4573afe3c..bc788a3f08e 100644 --- a/cloudtasks/v2beta2/cloudtasks-gen.go +++ b/cloudtasks/v2beta2/cloudtasks-gen.go @@ -2243,8 +2243,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 @@ -2373,7 +2373,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/cloudtasks/v2beta3/cloudtasks-api.json b/cloudtasks/v2beta3/cloudtasks-api.json index 397d4ce1868..20f44e2c0ee 100644 --- a/cloudtasks/v2beta3/cloudtasks-api.json +++ b/cloudtasks/v2beta3/cloudtasks-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" }, @@ -697,7 +697,7 @@ } } }, - "revision": "20220321", + "revision": "20220401", "rootUrl": "https://cloudtasks.googleapis.com/", "schemas": { "AppEngineHttpQueue": { diff --git a/cloudtasks/v2beta3/cloudtasks-gen.go b/cloudtasks/v2beta3/cloudtasks-gen.go index 8f791f637a5..c76024f85af 100644 --- a/cloudtasks/v2beta3/cloudtasks-gen.go +++ b/cloudtasks/v2beta3/cloudtasks-gen.go @@ -2191,8 +2191,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 @@ -2321,7 +2321,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/dlp/v2/dlp-api.json b/dlp/v2/dlp-api.json index ff868486727..2a08ca54504 100644 --- a/dlp/v2/dlp-api.json +++ b/dlp/v2/dlp-api.json @@ -3412,7 +3412,7 @@ } } }, - "revision": "20220319", + "revision": "20220402", "rootUrl": "https://dlp.googleapis.com/", "schemas": { "GooglePrivacyDlpV2Action": { @@ -3719,8 +3719,8 @@ "plain text", "docx, docm, dotx, dotm", "pdf", - "powerpoint", - "excel", + "pptx, pptm, potx, potm, pot", + "xlsx, xlsm, xltx, xltm", "avro", "csv", "tsv" @@ -4398,6 +4398,145 @@ }, "type": "object" }, + "GooglePrivacyDlpV2DataProfileAction": { + "description": "A task to execute when a data profile has been generated.", + "id": "GooglePrivacyDlpV2DataProfileAction", + "properties": { + "exportData": { + "$ref": "GooglePrivacyDlpV2Export", + "description": "Export data profiles into a provided location." + }, + "pubSubNotification": { + "$ref": "GooglePrivacyDlpV2PubSubNotification", + "description": "Publish a message into the Pub/Sub topic." + } + }, + "type": "object" + }, + "GooglePrivacyDlpV2DataProfileConfigSnapshot": { + "description": "Snapshot of the configurations used to generate the profile.", + "id": "GooglePrivacyDlpV2DataProfileConfigSnapshot", + "properties": { + "dataProfileJob": { + "$ref": "GooglePrivacyDlpV2DataProfileJobConfig", + "description": "A copy of the configuration used to generate this profile." + }, + "inspectConfig": { + "$ref": "GooglePrivacyDlpV2InspectConfig", + "description": "A copy of the inspection config used to generate this profile. This is a copy of the inspect_template specified in `DataProfileJobConfig`." + } + }, + "type": "object" + }, + "GooglePrivacyDlpV2DataProfileJobConfig": { + "description": "Configuration for setting up a job to scan resources for profile generation. Only one data profile configuration may exist per organization, folder, or project. The generated data profiles are retained according to the [data retention policy] (https://cloud.google.com/dlp/docs/data-profiles#retention).", + "id": "GooglePrivacyDlpV2DataProfileJobConfig", + "properties": { + "dataProfileActions": { + "description": "Actions to execute at the completion of the job.", + "items": { + "$ref": "GooglePrivacyDlpV2DataProfileAction" + }, + "type": "array" + }, + "inspectTemplates": { + "description": "Detection logic for profile generation. Not all template features are used by profiles. FindingLimits, include_quote and exclude_info_types have no impact on data profiling. Multiple templates may be provided if there is data in multiple regions. At most one template must be specified per-region (including \"global\"). Each region is scanned using the applicable template. If no region-specific template is specified, but a \"global\" template is specified, it will be copied to that region and used instead. If no global or region-specific template is provided for a region with data, that region's data will not be scanned. For more information, see https://cloud.google.com/dlp/docs/data-profiles#data_residency.", + "items": { + "type": "string" + }, + "type": "array" + }, + "location": { + "$ref": "GooglePrivacyDlpV2DataProfileLocation", + "description": "The data to scan." + }, + "projectId": { + "description": "The project that will run the scan. The DLP service account that exists within this project must have access to all resources that are profiled, and the Cloud DLP API must be enabled.", + "type": "string" + } + }, + "type": "object" + }, + "GooglePrivacyDlpV2DataProfileLocation": { + "description": "The data that will be profiled.", + "id": "GooglePrivacyDlpV2DataProfileLocation", + "properties": { + "folderId": { + "description": "The ID of the Folder within an organization to scan.", + "format": "int64", + "type": "string" + }, + "organizationId": { + "description": "The ID of an organization to scan.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "GooglePrivacyDlpV2DataProfilePubSubCondition": { + "description": "A condition for determining whether a PubSub should be triggered.", + "id": "GooglePrivacyDlpV2DataProfilePubSubCondition", + "properties": { + "expressions": { + "$ref": "GooglePrivacyDlpV2PubSubExpressions", + "description": "An expression." + } + }, + "type": "object" + }, + "GooglePrivacyDlpV2DataProfilePubSubMessage": { + "description": "The message that will be published to a Pub/Sub topic. To receive a message of protocol buffer schema type, convert the message data to an object of this proto class. https://cloud.google.com/pubsub/docs/samples/pubsub-subscribe-proto-messages", + "id": "GooglePrivacyDlpV2DataProfilePubSubMessage", + "properties": { + "event": { + "description": "The event that caused the Pub/Sub message to be sent.", + "enum": [ + "EVENT_TYPE_UNSPECIFIED", + "NEW_PROFILE", + "CHANGED_PROFILE", + "SCORE_INCREASED", + "ERROR_CHANGED" + ], + "enumDescriptions": [ + "Unused.", + "New profile (not a re-profile).", + "Changed one of the following profile metrics: * Table data risk score * Table sensitivity score * Table resource visibility * Table encryption type * Table predicted infoTypes * Table other infoTypes", + "Table data risk score or sensitivity score increased.", + "A user (non-internal) error occurred." + ], + "type": "string" + }, + "profile": { + "$ref": "GooglePrivacyDlpV2TableDataProfile", + "description": "If `DetailLevel` is `TABLE_PROFILE` this will be fully populated. Otherwise, if `DetailLevel` is `RESOURCE_NAME`, then only `name` and `full_resource` will be populated." + } + }, + "type": "object" + }, + "GooglePrivacyDlpV2DataRiskLevel": { + "description": "Score is a summary of all elements in the data profile. A higher number means more risky.", + "id": "GooglePrivacyDlpV2DataRiskLevel", + "properties": { + "score": { + "description": "The score applied to the resource.", + "enum": [ + "RISK_SCORE_UNSPECIFIED", + "RISK_LOW", + "RISK_MODERATE", + "RISK_HIGH" + ], + "enumDescriptions": [ + "Unused.", + "Low risk - Lower indication of sensitive data that appears to have additional access restrictions in place or no indication of sensitive data found.", + "Medium risk - Sensitive data may be present but additional access or fine grain access restrictions appears to be present. Consider limiting access even further or transforming data to mask.", + "High risk – SPII may be present. Access controls may include public ACLs. Exfiltration of data may lead to user data loss. Re-identification of users may be possible. Consider limiting usage and or removing SPII." + ], + "type": "string" + } + }, + "type": "object" + }, "GooglePrivacyDlpV2DatastoreKey": { "description": "Record key for a finding in Cloud Datastore.", "id": "GooglePrivacyDlpV2DatastoreKey", @@ -4883,6 +5022,17 @@ }, "type": "object" }, + "GooglePrivacyDlpV2Export": { + "description": "If set, the detailed data profiles will be persisted to the location of your choice whenever updated.", + "id": "GooglePrivacyDlpV2Export", + "properties": { + "profileTable": { + "$ref": "GooglePrivacyDlpV2BigQueryTable", + "description": "Store all table and column profiles in an existing table or a new table in an existing dataset. Each re-generation will result in a new row in BigQuery." + } + }, + "type": "object" + }, "GooglePrivacyDlpV2Expressions": { "description": "An expression, consisting or an operator and conditions.", "id": "GooglePrivacyDlpV2Expressions", @@ -5349,6 +5499,17 @@ }, "type": "object" }, + "GooglePrivacyDlpV2InfoTypeSummary": { + "description": "The infoType details for this column.", + "id": "GooglePrivacyDlpV2InfoTypeSummary", + "properties": { + "infoType": { + "$ref": "GooglePrivacyDlpV2InfoType", + "description": "The infoType." + } + }, + "type": "object" + }, "GooglePrivacyDlpV2InfoTypeTransformation": { "description": "A transformation to apply to text that is identified as a specific info_type.", "id": "GooglePrivacyDlpV2InfoTypeTransformation", @@ -6281,6 +6442,17 @@ }, "type": "object" }, + "GooglePrivacyDlpV2OtherInfoTypeSummary": { + "description": "Infotype details for other infoTypes found within a column.", + "id": "GooglePrivacyDlpV2OtherInfoTypeSummary", + "properties": { + "infoType": { + "$ref": "GooglePrivacyDlpV2InfoType", + "description": "The other infoType." + } + }, + "type": "object" + }, "GooglePrivacyDlpV2OutputStorageConfig": { "description": "Cloud repository for storing output.", "id": "GooglePrivacyDlpV2OutputStorageConfig", @@ -6433,6 +6605,21 @@ }, "type": "object" }, + "GooglePrivacyDlpV2ProfileStatus": { + "id": "GooglePrivacyDlpV2ProfileStatus", + "properties": { + "status": { + "$ref": "GoogleRpcStatus", + "description": "Profiling status code and optional message" + }, + "timestamp": { + "description": "Time when the profile generation status was updated", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "GooglePrivacyDlpV2Proximity": { "description": "Message for specifying a window around a finding to apply a detection rule.", "id": "GooglePrivacyDlpV2Proximity", @@ -6450,6 +6637,116 @@ }, "type": "object" }, + "GooglePrivacyDlpV2PubSubCondition": { + "description": "A condition consisting of a value.", + "id": "GooglePrivacyDlpV2PubSubCondition", + "properties": { + "minimumRiskScore": { + "description": "The minimum data risk score that triggers the condition.", + "enum": [ + "PROFILE_SCORE_BUCKET_UNSPECIFIED", + "HIGH", + "MEDIUM_OR_HIGH" + ], + "enumDescriptions": [ + "Unused.", + "High risk/sensitivity detected.", + "Medium or high risk/sensitivity detected." + ], + "type": "string" + }, + "minimumSensitivityScore": { + "description": "The minimum sensitivity level that triggers the condition.", + "enum": [ + "PROFILE_SCORE_BUCKET_UNSPECIFIED", + "HIGH", + "MEDIUM_OR_HIGH" + ], + "enumDescriptions": [ + "Unused.", + "High risk/sensitivity detected.", + "Medium or high risk/sensitivity detected." + ], + "type": "string" + } + }, + "type": "object" + }, + "GooglePrivacyDlpV2PubSubExpressions": { + "description": "An expression, consisting of an operator and conditions.", + "id": "GooglePrivacyDlpV2PubSubExpressions", + "properties": { + "conditions": { + "description": "Conditions to apply to the expression.", + "items": { + "$ref": "GooglePrivacyDlpV2PubSubCondition" + }, + "type": "array" + }, + "logicalOperator": { + "description": "The operator to apply to the collection of conditions.", + "enum": [ + "LOGICAL_OPERATOR_UNSPECIFIED", + "OR", + "AND" + ], + "enumDescriptions": [ + "Unused.", + "Conditional OR.", + "Conditional AND." + ], + "type": "string" + } + }, + "type": "object" + }, + "GooglePrivacyDlpV2PubSubNotification": { + "description": "Send a Pub/Sub message into the given Pub/Sub topic to connect other systems to data profile generation. The message payload data will be the byte serialization of `DataProfilePubSubMessage`.", + "id": "GooglePrivacyDlpV2PubSubNotification", + "properties": { + "detailOfMessage": { + "description": "How much data to include in the Pub/Sub message. If the user wishes to limit the size of the message, they can use resource_name and fetch the profile fields they wish to. Per table profile (not per column).", + "enum": [ + "DETAIL_LEVEL_UNSPECIFIED", + "TABLE_PROFILE", + "RESOURCE_NAME" + ], + "enumDescriptions": [ + "Unused.", + "The full table data profile.", + "The resource name of the table." + ], + "type": "string" + }, + "event": { + "description": "The type of event that triggers a Pub/Sub. At most one `PubSubNotification` per EventType is permitted.", + "enum": [ + "EVENT_TYPE_UNSPECIFIED", + "NEW_PROFILE", + "CHANGED_PROFILE", + "SCORE_INCREASED", + "ERROR_CHANGED" + ], + "enumDescriptions": [ + "Unused.", + "New profile (not a re-profile).", + "Changed one of the following profile metrics: * Table data risk score * Table sensitivity score * Table resource visibility * Table encryption type * Table predicted infoTypes * Table other infoTypes", + "Table data risk score or sensitivity score increased.", + "A user (non-internal) error occurred." + ], + "type": "string" + }, + "pubsubCondition": { + "$ref": "GooglePrivacyDlpV2DataProfilePubSubCondition", + "description": "Conditions (e.g., data risk or sensitivity level) for triggering a Pub/Sub." + }, + "topic": { + "description": "Cloud Pub/Sub topic to send notifications to. Format is projects/{project}/topics/{topic}.", + "type": "string" + } + }, + "type": "object" + }, "GooglePrivacyDlpV2PublishFindingsToCloudDataCatalog": { "description": "Publish findings of a DlpJob to Data Catalog. Labels summarizing the results of the DlpJob will be applied to the entry for the resource scanned in Data Catalog. Any labels previously written by another DlpJob will be deleted. InfoType naming patterns are strictly enforced when using this feature. Note that the findings will be persisted in Data Catalog storage and are governed by Data Catalog service-specific policy, see https://cloud.google.com/terms/service-terms Only a single instance of this action can be specified and only allowed if all resources being scanned are BigQuery tables. Compatible with: Inspect", "id": "GooglePrivacyDlpV2PublishFindingsToCloudDataCatalog", @@ -6904,6 +7201,29 @@ }, "type": "object" }, + "GooglePrivacyDlpV2SensitivityScore": { + "description": "Score is a summary of all elements in the data profile. A higher number means more sensitive.", + "id": "GooglePrivacyDlpV2SensitivityScore", + "properties": { + "score": { + "description": "The score applied to the resource.", + "enum": [ + "SENSITIVITY_SCORE_UNSPECIFIED", + "SENSITIVITY_LOW", + "SENSITIVITY_MODERATE", + "SENSITIVITY_HIGH" + ], + "enumDescriptions": [ + "Unused.", + "No sensitive information detected. Limited access.", + "Medium risk - PII, potentially sensitive data, or fields with free-text data that are at higher risk of having intermittent sensitive data. Consider limiting access.", + "High risk – SPII may be present. Exfiltration of data may lead to user data loss. Re-identification of users may be possible. Consider limiting usage and or removing SPII." + ], + "type": "string" + } + }, + "type": "object" + }, "GooglePrivacyDlpV2StatisticalTable": { "description": "An auxiliary table containing statistical information on the relative frequency of different quasi-identifiers values. It has one or several quasi-identifiers columns, and one column that indicates the relative frequency of each quasi-identifier tuple. If a tuple is present in the data but not in the auxiliary table, the corresponding relative frequency is assumed to be zero (and thus, the tuple is highly reidentifiable).", "id": "GooglePrivacyDlpV2StatisticalTable", @@ -7140,6 +7460,160 @@ }, "type": "object" }, + "GooglePrivacyDlpV2TableDataProfile": { + "description": "The profile for a scanned table.", + "id": "GooglePrivacyDlpV2TableDataProfile", + "properties": { + "configSnapshot": { + "$ref": "GooglePrivacyDlpV2DataProfileConfigSnapshot", + "description": "The snapshot of the configurations used to generate the profile." + }, + "createTime": { + "description": "The time at which the table was created.", + "format": "google-datetime", + "type": "string" + }, + "dataRiskLevel": { + "$ref": "GooglePrivacyDlpV2DataRiskLevel", + "description": "The data risk level of this table." + }, + "datasetId": { + "description": "The BigQuery dataset ID.", + "type": "string" + }, + "datasetLocation": { + "description": "The BigQuery location where the dataset's data is stored. See https://cloud.google.com/bigquery/docs/locations for supported locations.", + "type": "string" + }, + "datasetProjectId": { + "description": "The GCP project ID that owns the BigQuery dataset.", + "type": "string" + }, + "encryptionStatus": { + "description": "How the table is encrypted.", + "enum": [ + "ENCRYPTION_STATUS_UNSPECIFIED", + "ENCRYPTION_GOOGLE_MANAGED", + "ENCRYPTION_CUSTOMER_MANAGED" + ], + "enumDescriptions": [ + "Unused.", + "Google manages server-side encryption keys on your behalf.", + "Customer provides the key." + ], + "type": "string" + }, + "expirationTime": { + "description": "Optional. The time when this table expires.", + "format": "google-datetime", + "type": "string" + }, + "failedColumnCount": { + "description": "The number of columns skipped in the table because of an error.", + "format": "int64", + "type": "string" + }, + "fullResource": { + "description": "The resource name of the table. https://cloud.google.com/apis/design/resource_names#full_resource_name", + "type": "string" + }, + "lastModifiedTime": { + "description": "The time when this table was last modified", + "format": "google-datetime", + "type": "string" + }, + "name": { + "description": "The name of the profile.", + "type": "string" + }, + "otherInfoTypes": { + "description": "Other infoTypes found in this table's data.", + "items": { + "$ref": "GooglePrivacyDlpV2OtherInfoTypeSummary" + }, + "type": "array" + }, + "predictedInfoTypes": { + "description": "The infoTypes predicted from this table's data.", + "items": { + "$ref": "GooglePrivacyDlpV2InfoTypeSummary" + }, + "type": "array" + }, + "profileLastGenerated": { + "description": "The last time the profile was generated.", + "format": "google-datetime", + "type": "string" + }, + "profileStatus": { + "$ref": "GooglePrivacyDlpV2ProfileStatus", + "description": "Success or error status from the most recent profile generation attempt. May be empty if the profile is still being generated." + }, + "projectDataProfile": { + "description": "The resource name to the project data profile for this table.", + "type": "string" + }, + "resourceLabels": { + "additionalProperties": { + "type": "string" + }, + "description": "The labels applied to the resource at the time the profile was generated.", + "type": "object" + }, + "resourceVisibility": { + "description": "How broadly a resource has been shared.", + "enum": [ + "RESOURCE_VISIBILITY_UNSPECIFIED", + "RESOURCE_VISIBILITY_PUBLIC", + "RESOURCE_VISIBILITY_RESTRICTED" + ], + "enumDescriptions": [ + "Unused.", + "Visible to any user.", + "Visible only to specific users." + ], + "type": "string" + }, + "rowCount": { + "description": "Number of rows in the table when the profile was generated.", + "format": "int64", + "type": "string" + }, + "scannedColumnCount": { + "description": "The number of columns profiled in the table.", + "format": "int64", + "type": "string" + }, + "sensitivityScore": { + "$ref": "GooglePrivacyDlpV2SensitivityScore", + "description": "The sensitivity score of this table." + }, + "state": { + "description": "State of a profile.", + "enum": [ + "STATE_UNSPECIFIED", + "RUNNING", + "DONE" + ], + "enumDescriptions": [ + "Unused.", + "The profile is currently running. Once a profile has finished it will transition to DONE.", + "The profile is no longer generating. If profile_status.status.code is 0, the profile succeeded, otherwise, it failed." + ], + "type": "string" + }, + "tableId": { + "description": "The BigQuery table ID.", + "type": "string" + }, + "tableSizeBytes": { + "description": "The size of the table when the profile was generated.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, "GooglePrivacyDlpV2TableLocation": { "description": "Location of a finding within a table.", "id": "GooglePrivacyDlpV2TableLocation", diff --git a/dlp/v2/dlp-gen.go b/dlp/v2/dlp-gen.go index 1ae614ff373..3f074ec757b 100644 --- a/dlp/v2/dlp-gen.go +++ b/dlp/v2/dlp-gen.go @@ -940,8 +940,8 @@ type GooglePrivacyDlpV2ByteContentItem struct { // "TEXT_UTF8" - plain text // "WORD_DOCUMENT" - docx, docm, dotx, dotm // "PDF" - pdf - // "POWERPOINT_DOCUMENT" - powerpoint - // "EXCEL_DOCUMENT" - excel + // "POWERPOINT_DOCUMENT" - pptx, pptm, potx, potm, pot + // "EXCEL_DOCUMENT" - xlsx, xlsm, xltx, xltm // "AVRO" - avro // "CSV" - csv // "TSV" - tsv @@ -2241,6 +2241,280 @@ func (s *GooglePrivacyDlpV2CustomInfoType) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GooglePrivacyDlpV2DataProfileAction: A task to execute when a data +// profile has been generated. +type GooglePrivacyDlpV2DataProfileAction struct { + // ExportData: Export data profiles into a provided location. + ExportData *GooglePrivacyDlpV2Export `json:"exportData,omitempty"` + + // PubSubNotification: Publish a message into the Pub/Sub topic. + PubSubNotification *GooglePrivacyDlpV2PubSubNotification `json:"pubSubNotification,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ExportData") 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. "ExportData") 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 *GooglePrivacyDlpV2DataProfileAction) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2DataProfileAction + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GooglePrivacyDlpV2DataProfileConfigSnapshot: Snapshot of the +// configurations used to generate the profile. +type GooglePrivacyDlpV2DataProfileConfigSnapshot struct { + // DataProfileJob: A copy of the configuration used to generate this + // profile. + DataProfileJob *GooglePrivacyDlpV2DataProfileJobConfig `json:"dataProfileJob,omitempty"` + + // InspectConfig: A copy of the inspection config used to generate this + // profile. This is a copy of the inspect_template specified in + // `DataProfileJobConfig`. + InspectConfig *GooglePrivacyDlpV2InspectConfig `json:"inspectConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DataProfileJob") 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. "DataProfileJob") 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 *GooglePrivacyDlpV2DataProfileConfigSnapshot) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2DataProfileConfigSnapshot + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GooglePrivacyDlpV2DataProfileJobConfig: Configuration for setting up +// a job to scan resources for profile generation. Only one data profile +// configuration may exist per organization, folder, or project. The +// generated data profiles are retained according to the [data retention +// policy] (https://cloud.google.com/dlp/docs/data-profiles#retention). +type GooglePrivacyDlpV2DataProfileJobConfig struct { + // DataProfileActions: Actions to execute at the completion of the job. + DataProfileActions []*GooglePrivacyDlpV2DataProfileAction `json:"dataProfileActions,omitempty"` + + // InspectTemplates: Detection logic for profile generation. Not all + // template features are used by profiles. FindingLimits, include_quote + // and exclude_info_types have no impact on data profiling. Multiple + // templates may be provided if there is data in multiple regions. At + // most one template must be specified per-region (including "global"). + // Each region is scanned using the applicable template. If no + // region-specific template is specified, but a "global" template is + // specified, it will be copied to that region and used instead. If no + // global or region-specific template is provided for a region with + // data, that region's data will not be scanned. For more information, + // see https://cloud.google.com/dlp/docs/data-profiles#data_residency. + InspectTemplates []string `json:"inspectTemplates,omitempty"` + + // Location: The data to scan. + Location *GooglePrivacyDlpV2DataProfileLocation `json:"location,omitempty"` + + // ProjectId: The project that will run the scan. The DLP service + // account that exists within this project must have access to all + // resources that are profiled, and the Cloud DLP API must be enabled. + ProjectId string `json:"projectId,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DataProfileActions") + // 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. "DataProfileActions") 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 *GooglePrivacyDlpV2DataProfileJobConfig) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2DataProfileJobConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GooglePrivacyDlpV2DataProfileLocation: The data that will be +// profiled. +type GooglePrivacyDlpV2DataProfileLocation struct { + // FolderId: The ID of the Folder within an organization to scan. + FolderId int64 `json:"folderId,omitempty,string"` + + // OrganizationId: The ID of an organization to scan. + OrganizationId int64 `json:"organizationId,omitempty,string"` + + // ForceSendFields is a list of field names (e.g. "FolderId") 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. "FolderId") 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 *GooglePrivacyDlpV2DataProfileLocation) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2DataProfileLocation + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GooglePrivacyDlpV2DataProfilePubSubCondition: A condition for +// determining whether a PubSub should be triggered. +type GooglePrivacyDlpV2DataProfilePubSubCondition struct { + // Expressions: An expression. + Expressions *GooglePrivacyDlpV2PubSubExpressions `json:"expressions,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Expressions") 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. "Expressions") 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 *GooglePrivacyDlpV2DataProfilePubSubCondition) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2DataProfilePubSubCondition + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GooglePrivacyDlpV2DataProfilePubSubMessage: The message that will be +// published to a Pub/Sub topic. To receive a message of protocol buffer +// schema type, convert the message data to an object of this proto +// class. +// https://cloud.google.com/pubsub/docs/samples/pubsub-subscribe-proto-messages +type GooglePrivacyDlpV2DataProfilePubSubMessage struct { + // Event: The event that caused the Pub/Sub message to be sent. + // + // Possible values: + // "EVENT_TYPE_UNSPECIFIED" - Unused. + // "NEW_PROFILE" - New profile (not a re-profile). + // "CHANGED_PROFILE" - Changed one of the following profile metrics: * + // Table data risk score * Table sensitivity score * Table resource + // visibility * Table encryption type * Table predicted infoTypes * + // Table other infoTypes + // "SCORE_INCREASED" - Table data risk score or sensitivity score + // increased. + // "ERROR_CHANGED" - A user (non-internal) error occurred. + Event string `json:"event,omitempty"` + + // Profile: If `DetailLevel` is `TABLE_PROFILE` this will be fully + // populated. Otherwise, if `DetailLevel` is `RESOURCE_NAME`, then only + // `name` and `full_resource` will be populated. + Profile *GooglePrivacyDlpV2TableDataProfile `json:"profile,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Event") 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. "Event") 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 *GooglePrivacyDlpV2DataProfilePubSubMessage) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2DataProfilePubSubMessage + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GooglePrivacyDlpV2DataRiskLevel: Score is a summary of all elements +// in the data profile. A higher number means more risky. +type GooglePrivacyDlpV2DataRiskLevel struct { + // Score: The score applied to the resource. + // + // Possible values: + // "RISK_SCORE_UNSPECIFIED" - Unused. + // "RISK_LOW" - Low risk - Lower indication of sensitive data that + // appears to have additional access restrictions in place or no + // indication of sensitive data found. + // "RISK_MODERATE" - Medium risk - Sensitive data may be present but + // additional access or fine grain access restrictions appears to be + // present. Consider limiting access even further or transforming data + // to mask. + // "RISK_HIGH" - High risk – SPII may be present. Access controls + // may include public ACLs. Exfiltration of data may lead to user data + // loss. Re-identification of users may be possible. Consider limiting + // usage and or removing SPII. + Score string `json:"score,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Score") 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. "Score") 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 *GooglePrivacyDlpV2DataRiskLevel) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2DataRiskLevel + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GooglePrivacyDlpV2DatastoreKey: Record key for a finding in Cloud // Datastore. type GooglePrivacyDlpV2DatastoreKey struct { @@ -3147,6 +3421,37 @@ func (s *GooglePrivacyDlpV2ExclusionRule) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GooglePrivacyDlpV2Export: If set, the detailed data profiles will be +// persisted to the location of your choice whenever updated. +type GooglePrivacyDlpV2Export struct { + // ProfileTable: Store all table and column profiles in an existing + // table or a new table in an existing dataset. Each re-generation will + // result in a new row in BigQuery. + ProfileTable *GooglePrivacyDlpV2BigQueryTable `json:"profileTable,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ProfileTable") 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. "ProfileTable") 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 *GooglePrivacyDlpV2Export) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2Export + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GooglePrivacyDlpV2Expressions: An expression, consisting or an // operator and conditions. type GooglePrivacyDlpV2Expressions struct { @@ -4025,6 +4330,35 @@ func (s *GooglePrivacyDlpV2InfoTypeStats) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GooglePrivacyDlpV2InfoTypeSummary: The infoType details for this +// column. +type GooglePrivacyDlpV2InfoTypeSummary struct { + // InfoType: The infoType. + InfoType *GooglePrivacyDlpV2InfoType `json:"infoType,omitempty"` + + // ForceSendFields is a list of field names (e.g. "InfoType") 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. "InfoType") 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 *GooglePrivacyDlpV2InfoTypeSummary) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2InfoTypeSummary + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GooglePrivacyDlpV2InfoTypeTransformation: A transformation to apply // to text that is identified as a specific info_type. type GooglePrivacyDlpV2InfoTypeTransformation struct { @@ -5670,6 +6004,35 @@ func (s *GooglePrivacyDlpV2NumericalStatsResult) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GooglePrivacyDlpV2OtherInfoTypeSummary: Infotype details for other +// infoTypes found within a column. +type GooglePrivacyDlpV2OtherInfoTypeSummary struct { + // InfoType: The other infoType. + InfoType *GooglePrivacyDlpV2InfoType `json:"infoType,omitempty"` + + // ForceSendFields is a list of field names (e.g. "InfoType") 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. "InfoType") 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 *GooglePrivacyDlpV2OtherInfoTypeSummary) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2OtherInfoTypeSummary + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GooglePrivacyDlpV2OutputStorageConfig: Cloud repository for storing // output. type GooglePrivacyDlpV2OutputStorageConfig struct { @@ -5920,6 +6283,36 @@ func (s *GooglePrivacyDlpV2PrivacyMetric) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +type GooglePrivacyDlpV2ProfileStatus struct { + // Status: Profiling status code and optional message + Status *GoogleRpcStatus `json:"status,omitempty"` + + // Timestamp: Time when the profile generation status was updated + Timestamp string `json:"timestamp,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Status") 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. "Status") 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 *GooglePrivacyDlpV2ProfileStatus) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2ProfileStatus + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GooglePrivacyDlpV2Proximity: Message for specifying a window around a // finding to apply a detection rule. type GooglePrivacyDlpV2Proximity struct { @@ -5952,6 +6345,151 @@ func (s *GooglePrivacyDlpV2Proximity) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GooglePrivacyDlpV2PubSubCondition: A condition consisting of a value. +type GooglePrivacyDlpV2PubSubCondition struct { + // MinimumRiskScore: The minimum data risk score that triggers the + // condition. + // + // Possible values: + // "PROFILE_SCORE_BUCKET_UNSPECIFIED" - Unused. + // "HIGH" - High risk/sensitivity detected. + // "MEDIUM_OR_HIGH" - Medium or high risk/sensitivity detected. + MinimumRiskScore string `json:"minimumRiskScore,omitempty"` + + // MinimumSensitivityScore: The minimum sensitivity level that triggers + // the condition. + // + // Possible values: + // "PROFILE_SCORE_BUCKET_UNSPECIFIED" - Unused. + // "HIGH" - High risk/sensitivity detected. + // "MEDIUM_OR_HIGH" - Medium or high risk/sensitivity detected. + MinimumSensitivityScore string `json:"minimumSensitivityScore,omitempty"` + + // ForceSendFields is a list of field names (e.g. "MinimumRiskScore") 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. "MinimumRiskScore") 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 *GooglePrivacyDlpV2PubSubCondition) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2PubSubCondition + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GooglePrivacyDlpV2PubSubExpressions: An expression, consisting of an +// operator and conditions. +type GooglePrivacyDlpV2PubSubExpressions struct { + // Conditions: Conditions to apply to the expression. + Conditions []*GooglePrivacyDlpV2PubSubCondition `json:"conditions,omitempty"` + + // LogicalOperator: The operator to apply to the collection of + // conditions. + // + // Possible values: + // "LOGICAL_OPERATOR_UNSPECIFIED" - Unused. + // "OR" - Conditional OR. + // "AND" - Conditional AND. + LogicalOperator string `json:"logicalOperator,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Conditions") 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. "Conditions") 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 *GooglePrivacyDlpV2PubSubExpressions) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2PubSubExpressions + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GooglePrivacyDlpV2PubSubNotification: Send a Pub/Sub message into the +// given Pub/Sub topic to connect other systems to data profile +// generation. The message payload data will be the byte serialization +// of `DataProfilePubSubMessage`. +type GooglePrivacyDlpV2PubSubNotification struct { + // DetailOfMessage: How much data to include in the Pub/Sub message. If + // the user wishes to limit the size of the message, they can use + // resource_name and fetch the profile fields they wish to. Per table + // profile (not per column). + // + // Possible values: + // "DETAIL_LEVEL_UNSPECIFIED" - Unused. + // "TABLE_PROFILE" - The full table data profile. + // "RESOURCE_NAME" - The resource name of the table. + DetailOfMessage string `json:"detailOfMessage,omitempty"` + + // Event: The type of event that triggers a Pub/Sub. At most one + // `PubSubNotification` per EventType is permitted. + // + // Possible values: + // "EVENT_TYPE_UNSPECIFIED" - Unused. + // "NEW_PROFILE" - New profile (not a re-profile). + // "CHANGED_PROFILE" - Changed one of the following profile metrics: * + // Table data risk score * Table sensitivity score * Table resource + // visibility * Table encryption type * Table predicted infoTypes * + // Table other infoTypes + // "SCORE_INCREASED" - Table data risk score or sensitivity score + // increased. + // "ERROR_CHANGED" - A user (non-internal) error occurred. + Event string `json:"event,omitempty"` + + // PubsubCondition: Conditions (e.g., data risk or sensitivity level) + // for triggering a Pub/Sub. + PubsubCondition *GooglePrivacyDlpV2DataProfilePubSubCondition `json:"pubsubCondition,omitempty"` + + // Topic: Cloud Pub/Sub topic to send notifications to. Format is + // projects/{project}/topics/{topic}. + Topic string `json:"topic,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DetailOfMessage") 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. "DetailOfMessage") 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 *GooglePrivacyDlpV2PubSubNotification) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2PubSubNotification + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GooglePrivacyDlpV2PublishFindingsToCloudDataCatalog: Publish findings // of a DlpJob to Data Catalog. Labels summarizing the results of the // DlpJob will be applied to the entry for the resource scanned in Data @@ -6886,6 +7424,46 @@ func (s *GooglePrivacyDlpV2Schedule) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GooglePrivacyDlpV2SensitivityScore: Score is a summary of all +// elements in the data profile. A higher number means more sensitive. +type GooglePrivacyDlpV2SensitivityScore struct { + // Score: The score applied to the resource. + // + // Possible values: + // "SENSITIVITY_SCORE_UNSPECIFIED" - Unused. + // "SENSITIVITY_LOW" - No sensitive information detected. Limited + // access. + // "SENSITIVITY_MODERATE" - Medium risk - PII, potentially sensitive + // data, or fields with free-text data that are at higher risk of having + // intermittent sensitive data. Consider limiting access. + // "SENSITIVITY_HIGH" - High risk – SPII may be present. + // Exfiltration of data may lead to user data loss. Re-identification of + // users may be possible. Consider limiting usage and or removing SPII. + Score string `json:"score,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Score") 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. "Score") 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 *GooglePrivacyDlpV2SensitivityScore) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2SensitivityScore + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GooglePrivacyDlpV2StatisticalTable: An auxiliary table containing // statistical information on the relative frequency of different // quasi-identifiers values. It has one or several quasi-identifiers @@ -7303,6 +7881,135 @@ func (s *GooglePrivacyDlpV2Table) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GooglePrivacyDlpV2TableDataProfile: The profile for a scanned table. +type GooglePrivacyDlpV2TableDataProfile struct { + // ConfigSnapshot: The snapshot of the configurations used to generate + // the profile. + ConfigSnapshot *GooglePrivacyDlpV2DataProfileConfigSnapshot `json:"configSnapshot,omitempty"` + + // CreateTime: The time at which the table was created. + CreateTime string `json:"createTime,omitempty"` + + // DataRiskLevel: The data risk level of this table. + DataRiskLevel *GooglePrivacyDlpV2DataRiskLevel `json:"dataRiskLevel,omitempty"` + + // DatasetId: The BigQuery dataset ID. + DatasetId string `json:"datasetId,omitempty"` + + // DatasetLocation: The BigQuery location where the dataset's data is + // stored. See https://cloud.google.com/bigquery/docs/locations for + // supported locations. + DatasetLocation string `json:"datasetLocation,omitempty"` + + // DatasetProjectId: The GCP project ID that owns the BigQuery dataset. + DatasetProjectId string `json:"datasetProjectId,omitempty"` + + // EncryptionStatus: How the table is encrypted. + // + // Possible values: + // "ENCRYPTION_STATUS_UNSPECIFIED" - Unused. + // "ENCRYPTION_GOOGLE_MANAGED" - Google manages server-side encryption + // keys on your behalf. + // "ENCRYPTION_CUSTOMER_MANAGED" - Customer provides the key. + EncryptionStatus string `json:"encryptionStatus,omitempty"` + + // ExpirationTime: Optional. The time when this table expires. + ExpirationTime string `json:"expirationTime,omitempty"` + + // FailedColumnCount: The number of columns skipped in the table because + // of an error. + FailedColumnCount int64 `json:"failedColumnCount,omitempty,string"` + + // FullResource: The resource name of the table. + // https://cloud.google.com/apis/design/resource_names#full_resource_name + FullResource string `json:"fullResource,omitempty"` + + // LastModifiedTime: The time when this table was last modified + LastModifiedTime string `json:"lastModifiedTime,omitempty"` + + // Name: The name of the profile. + Name string `json:"name,omitempty"` + + // OtherInfoTypes: Other infoTypes found in this table's data. + OtherInfoTypes []*GooglePrivacyDlpV2OtherInfoTypeSummary `json:"otherInfoTypes,omitempty"` + + // PredictedInfoTypes: The infoTypes predicted from this table's data. + PredictedInfoTypes []*GooglePrivacyDlpV2InfoTypeSummary `json:"predictedInfoTypes,omitempty"` + + // ProfileLastGenerated: The last time the profile was generated. + ProfileLastGenerated string `json:"profileLastGenerated,omitempty"` + + // ProfileStatus: Success or error status from the most recent profile + // generation attempt. May be empty if the profile is still being + // generated. + ProfileStatus *GooglePrivacyDlpV2ProfileStatus `json:"profileStatus,omitempty"` + + // ProjectDataProfile: The resource name to the project data profile for + // this table. + ProjectDataProfile string `json:"projectDataProfile,omitempty"` + + // ResourceLabels: The labels applied to the resource at the time the + // profile was generated. + ResourceLabels map[string]string `json:"resourceLabels,omitempty"` + + // ResourceVisibility: How broadly a resource has been shared. + // + // Possible values: + // "RESOURCE_VISIBILITY_UNSPECIFIED" - Unused. + // "RESOURCE_VISIBILITY_PUBLIC" - Visible to any user. + // "RESOURCE_VISIBILITY_RESTRICTED" - Visible only to specific users. + ResourceVisibility string `json:"resourceVisibility,omitempty"` + + // RowCount: Number of rows in the table when the profile was generated. + RowCount int64 `json:"rowCount,omitempty,string"` + + // ScannedColumnCount: The number of columns profiled in the table. + ScannedColumnCount int64 `json:"scannedColumnCount,omitempty,string"` + + // SensitivityScore: The sensitivity score of this table. + SensitivityScore *GooglePrivacyDlpV2SensitivityScore `json:"sensitivityScore,omitempty"` + + // State: State of a profile. + // + // Possible values: + // "STATE_UNSPECIFIED" - Unused. + // "RUNNING" - The profile is currently running. Once a profile has + // finished it will transition to DONE. + // "DONE" - The profile is no longer generating. If + // profile_status.status.code is 0, the profile succeeded, otherwise, it + // failed. + State string `json:"state,omitempty"` + + // TableId: The BigQuery table ID. + TableId string `json:"tableId,omitempty"` + + // TableSizeBytes: The size of the table when the profile was generated. + TableSizeBytes int64 `json:"tableSizeBytes,omitempty,string"` + + // ForceSendFields is a list of field names (e.g. "ConfigSnapshot") 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. "ConfigSnapshot") 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 *GooglePrivacyDlpV2TableDataProfile) MarshalJSON() ([]byte, error) { + type NoMethod GooglePrivacyDlpV2TableDataProfile + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GooglePrivacyDlpV2TableLocation: Location of a finding within a // table. type GooglePrivacyDlpV2TableLocation struct { diff --git a/eventarc/v1beta1/eventarc-api.json b/eventarc/v1beta1/eventarc-api.json index 6e781a1155d..61bb7fd0cc9 100644 --- a/eventarc/v1beta1/eventarc-api.json +++ b/eventarc/v1beta1/eventarc-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" }, @@ -584,7 +584,7 @@ } } }, - "revision": "20220318", + "revision": "20220408", "rootUrl": "https://eventarc.googleapis.com/", "schemas": { "AuditConfig": { @@ -644,7 +644,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" }, @@ -964,7 +964,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\"`", @@ -1006,7 +1006,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/eventarc/v1beta1/eventarc-gen.go b/eventarc/v1beta1/eventarc-gen.go index ec901849315..51d22a6a35f 100644 --- a/eventarc/v1beta1/eventarc-gen.go +++ b/eventarc/v1beta1/eventarc-gen.go @@ -291,8 +291,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 @@ -967,7 +967,7 @@ func (s *Pubsub) 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"` @@ -1048,7 +1048,7 @@ func (s *Status) 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"` @@ -1388,8 +1388,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 @@ -1518,7 +1518,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/v1beta1/file-api.json b/file/v1beta1/file-api.json index 54f8c08e732..8cab6beebba 100644 --- a/file/v1beta1/file-api.json +++ b/file/v1beta1/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" }, @@ -874,7 +874,7 @@ } } }, - "revision": "20220222", + "revision": "20220407", "rootUrl": "https://file.googleapis.com/", "schemas": { "Backup": { @@ -1002,7 +1002,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": { @@ -1043,7 +1043,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" @@ -1089,7 +1089,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": { @@ -1118,14 +1118,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": { @@ -1268,6 +1268,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", @@ -1370,12 +1384,6 @@ "description": "Resource labels to represent user provided metadata.", "type": "object" }, - "maxShareCount": { - "description": "Output only. The max number of shares allowed.", - "format": "int64", - "readOnly": true, - "type": "string" - }, "name": { "description": "Output only. The resource name of the instance, in the format `projects/{project_id}/locations/{location_id}/instances/{instance_id}`.", "readOnly": true, diff --git a/file/v1beta1/file-gen.go b/file/v1beta1/file-gen.go index f89bcaacd8f..b90d0338136 100644 --- a/file/v1beta1/file-gen.go +++ b/file/v1beta1/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. @@ -502,11 +502,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 @@ -531,16 +532,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 @@ -754,6 +757,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 { @@ -937,9 +970,6 @@ type Instance struct { // Labels: Resource labels to represent user provided metadata. Labels map[string]string `json:"labels,omitempty"` - // MaxShareCount: Output only. The max number of shares allowed. - MaxShareCount int64 `json:"maxShareCount,omitempty,string"` - // Name: Output only. The resource name of the instance, in the format // `projects/{project_id}/locations/{location_id}/instances/{instance_id} // `. @@ -2140,8 +2170,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 @@ -2278,7 +2308,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 new file mode 100644 index 00000000000..d65d22ed1df --- /dev/null +++ b/gkebackup/v1/gkebackup-api.json @@ -0,0 +1,3080 @@ +{ + "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://gkebackup.googleapis.com/", + "batchPath": "batch", + "canonicalName": "Backup for GKE", + "description": "Backup for GKE is a managed Kubernetes workload backup and restore service for GKE clusters.", + "discoveryVersion": "v1", + "documentationLink": "https://cloud.google.com/kubernetes-engine/docs/add-on/backup-for-gke", + "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": "gkebackup:v1", + "kind": "discovery#restDescription", + "mtlsRootUrl": "https://gkebackup.mtls.googleapis.com/", + "name": "gkebackup", + "ownerDomain": "google.com", + "ownerName": "Google", + "parameters": { + "$.xgafv": { + "description": "V1 error format.", + "enum": [ + "1", + "2" + ], + "enumDescriptions": [ + "v1 error format", + "v2 error format" + ], + "location": "query", + "type": "string" + }, + "access_token": { + "description": "OAuth access token.", + "location": "query", + "type": "string" + }, + "alt": { + "default": "json", + "description": "Data format for response.", + "enum": [ + "json", + "media", + "proto" + ], + "enumDescriptions": [ + "Responses with Content-Type of application/json", + "Media download with context-dependent Content-Type", + "Responses with Content-Type of application/x-protobuf" + ], + "location": "query", + "type": "string" + }, + "callback": { + "description": "JSONP", + "location": "query", + "type": "string" + }, + "fields": { + "description": "Selector specifying which fields to include in a partial response.", + "location": "query", + "type": "string" + }, + "key": { + "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", + "location": "query", + "type": "string" + }, + "oauth_token": { + "description": "OAuth 2.0 token for the current user.", + "location": "query", + "type": "string" + }, + "prettyPrint": { + "default": "true", + "description": "Returns response with indentations and line breaks.", + "location": "query", + "type": "boolean" + }, + "quotaUser": { + "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", + "location": "query", + "type": "string" + }, + "uploadType": { + "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", + "location": "query", + "type": "string" + }, + "upload_protocol": { + "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", + "location": "query", + "type": "string" + } + }, + "protocol": "rest", + "resources": { + "projects": { + "resources": { + "locations": { + "methods": { + "deleteOperations": { + "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations", + "httpMethod": "DELETE", + "id": "gkebackup.projects.locations.deleteOperations", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be deleted.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}/operations", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Gets information about a location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Resource name for the location.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Location" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists information about the supported locations for this service.", + "flatPath": "v1/projects/{projectsId}/locations", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.list", + "parameterOrder": [ + "name" + ], + "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).", + "location": "query", + "type": "string" + }, + "name": { + "description": "The resource that owns the locations collection, if applicable.", + "location": "path", + "pattern": "^projects/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The maximum number of results to return. If not set, the service selects a default.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}/locations", + "response": { + "$ref": "ListLocationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "backupPlans": { + "methods": { + "create": { + "description": "Creates a new BackupPlan in a given location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans", + "httpMethod": "POST", + "id": "gkebackup.projects.locations.backupPlans.create", + "parameterOrder": [ + "parent" + ], + "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", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The location within which to create the BackupPlan. Format: projects/{project}/locations/{location}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/backupPlans", + "request": { + "$ref": "BackupPlan" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes an existing BackupPlan.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}", + "httpMethod": "DELETE", + "id": "gkebackup.projects.locations.backupPlans.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "etag": { + "description": "If provided, this value must match the value currently assigned to the target resource.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. Fully qualified BackupPlan name. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Retrieve the details of a single BackupPlan.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.backupPlans.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Fully qualified BackupPlan name. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "BackupPlan" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}:getIamPolicy", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.backupPlans.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists BackupPlans in a given location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.backupPlans.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "List filter.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Sort results.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "The target number of results to return in a single response. If not specified, a default value will be chosen by the service. Note that the response may inclue a partial list and a caller should only rely on the response's next_page_token to determine if there are more instances left to be queried.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The value of next_page_token received from a previous `ListBackupPlans` call. Provide this to retrieve the subsequent page in a multi-page list of results. When paginating, all other parameters provided to `ListBackupPlans` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The location that contains the BackupPlans to list. Format: projects/{project}/locations/{location}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/backupPlans", + "response": { + "$ref": "ListBackupPlansResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Update a BackupPlan.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}", + "httpMethod": "PATCH", + "id": "gkebackup.projects.locations.backupPlans.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. [Output Only] The full name of the BackupPlan resource. Format: projects/*/locations/*/backupPlans/*", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "This is used to specify the fields to be overwritten in the BackupPlan targeted for update. The values for each of these updated fields will be taken from the `backup_plan` provided with this request. Field names are relative to the root of the resource (e.g., `description`, `backup_config.include_volume_data`, etc.) If no `update_mask` is provided, all fields in `backup_plan` will be written to the target BackupPlan resource. Note that OUTPUT_ONLY and IMMUTABLE fields in `backup_plan` are ignored and are not used to update the target BackupPlan.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "BackupPlan" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}:setIamPolicy", + "httpMethod": "POST", + "id": "gkebackup.projects.locations.backupPlans.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "SetIamPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}:testIamPermissions", + "httpMethod": "POST", + "id": "gkebackup.projects.locations.backupPlans.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "TestIamPermissionsRequest" + }, + "response": { + "$ref": "TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "backups": { + "methods": { + "create": { + "description": "Creates a Backup for the given BackupPlan.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups", + "httpMethod": "POST", + "id": "gkebackup.projects.locations.backupPlans.backups.create", + "parameterOrder": [ + "parent" + ], + "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", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The BackupPlan within which to create the Backup. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/backups", + "request": { + "$ref": "Backup" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes an existing Backup.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}", + "httpMethod": "DELETE", + "id": "gkebackup.projects.locations.backupPlans.backups.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "etag": { + "description": "etag, if provided, it must match the server's etag for the delete to happen.", + "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.", + "location": "query", + "type": "boolean" + }, + "name": { + "description": "Required. Name of the Backup resource. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}/backups/{backup}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Retrieve the details of a single Backup.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.backupPlans.backups.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Full name of the Backup resource. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}/backups/{backup}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Backup" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}:getIamPolicy", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.backupPlans.backups.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists the Backups for a given BackupPlan.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.backupPlans.backups.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "List filter.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Sort results.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "The target number of results to return in a single response. If not specified, a default value will be chosen by the service. Note that the response may inclue a partial list and a caller should only rely on the response's next_page_token to determine if there are more instances left to be queried.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The value of next_page_token received from a previous `ListBackups` call. Provide this to retrieve the subsequent page in a multi-page list of results. When paginating, all other parameters provided to `ListBackups` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The BackupPlan that contains the Backups to list. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/backups", + "response": { + "$ref": "ListBackupsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Update a Backup.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}", + "httpMethod": "PATCH", + "id": "gkebackup.projects.locations.backupPlans.backups.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. The fully qualified name of the Backup. projects/*/locations/*/backupPlans/*/backups/*", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "This is used to specify the fields to be overwritten in the Backup targeted for update. The values for each of these updated fields will be taken from the `backup_plan` provided with this request. Field names are relative to the root of the resource. If no `update_mask` is provided, all fields in `backup` will be written to the target Backup resource. Note that OUTPUT_ONLY and IMMUTABLE fields in `backup` are ignored and are not used to update the target Backup.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "Backup" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}:setIamPolicy", + "httpMethod": "POST", + "id": "gkebackup.projects.locations.backupPlans.backups.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "SetIamPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}:testIamPermissions", + "httpMethod": "POST", + "id": "gkebackup.projects.locations.backupPlans.backups.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "TestIamPermissionsRequest" + }, + "response": { + "$ref": "TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "volumeBackups": { + "methods": { + "get": { + "description": "Retrieve the details of a single VolumeBackup.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}/volumeBackups/{volumeBackupsId}", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.backupPlans.backups.volumeBackups.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Full name of the VolumeBackup resource. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}/backups/{backup}/volumeBackups/{volume_backup}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+/volumeBackups/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "VolumeBackup" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}/volumeBackups/{volumeBackupsId}:getIamPolicy", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.backupPlans.backups.volumeBackups.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+/volumeBackups/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists the VolumeBackups for a given Backup.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}/volumeBackups", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.backupPlans.backups.volumeBackups.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "List filter.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Sort results.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "The target number of results to return in a single response. If not specified, a default value will be chosen by the service. Note that the response may inclue a partial list and a caller should only rely on the response's next_page_token to determine if there are more instances left to be queried.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The value of next_page_token received from a previous `ListVolumeBackups` call. Provide this to retrieve the subsequent page in a multi-page list of results. When paginating, all other parameters provided to `ListVolumeBackups` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The Backup that contains the VolumeBackups to list. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}/backups/{backup}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/volumeBackups", + "response": { + "$ref": "ListVolumeBackupsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}/volumeBackups/{volumeBackupsId}:setIamPolicy", + "httpMethod": "POST", + "id": "gkebackup.projects.locations.backupPlans.backups.volumeBackups.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+/volumeBackups/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "SetIamPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}/volumeBackups/{volumeBackupsId}:testIamPermissions", + "httpMethod": "POST", + "id": "gkebackup.projects.locations.backupPlans.backups.volumeBackups.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+/volumeBackups/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "TestIamPermissionsRequest" + }, + "response": { + "$ref": "TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + } + } + }, + "operations": { + "methods": { + "cancel": { + "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", + "httpMethod": "POST", + "id": "gkebackup.projects.locations.operations.cancel", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource to be cancelled.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}:cancel", + "request": { + "$ref": "GoogleLongrunningCancelOperationRequest" + }, + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "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": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.operations.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "The name of the operation resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to override the binding to use different resource name schemes, such as `users/*/operations`. To override the binding, API services can add a binding such as `\"/v1/{name=users/*}/operations\"` to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.operations.list", + "parameterOrder": [ + "name" + ], + "parameters": { + "filter": { + "description": "The standard list filter.", + "location": "query", + "type": "string" + }, + "name": { + "description": "The name of the operation's parent resource.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "The standard list page size.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The standard list page token.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}/operations", + "response": { + "$ref": "GoogleLongrunningListOperationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, + "restorePlans": { + "methods": { + "create": { + "description": "Creates a new RestorePlan in a given location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans", + "httpMethod": "POST", + "id": "gkebackup.projects.locations.restorePlans.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The location within which to create the RestorePlan. Format: projects/{project}/locations/{location}", + "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", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/restorePlans", + "request": { + "$ref": "RestorePlan" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes an existing RestorePlan.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}", + "httpMethod": "DELETE", + "id": "gkebackup.projects.locations.restorePlans.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "etag": { + "description": "If provided, this value must match the value currently assigned to the target resource.", + "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.", + "location": "query", + "type": "boolean" + }, + "name": { + "description": "Required. Fully qualified RestorePlan name. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Retrieve the details of a single RestorePlan.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.restorePlans.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Fully qualified RestorePlan name. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "RestorePlan" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}:getIamPolicy", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.restorePlans.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists RestorePlans in a given location.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.restorePlans.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "List filter.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Sort results.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "The target number of results to return in a single response. If not specified, a default value will be chosen by the service. Note that the response may inclue a partial list and a caller should only rely on the response's next_page_token to determine if there are more instances left to be queried.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The value of next_page_token received from a previous `ListRestorePlans` call. Provide this to retrieve the subsequent page in a multi-page list of results. When paginating, all other parameters provided to `ListRestorePlans` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The location that contains the RestorePlans to list. Format: projects/{project}/locations/{location}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/restorePlans", + "response": { + "$ref": "ListRestorePlansResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Update a RestorePlan.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}", + "httpMethod": "PATCH", + "id": "gkebackup.projects.locations.restorePlans.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. [Output Only] The full name of the RestorePlan resource. Format: projects/*/locations/*/restorePlans/*", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "This is used to specify the fields to be overwritten in the RestorePlan targeted for update. The values for each of these updated fields will be taken from the `restore_plan` provided with this request. Field names are relative to the root of the resource. If no `update_mask` is provided, all fields in `restore_plan` will be written to the target RestorePlan resource. Note that OUTPUT_ONLY and IMMUTABLE fields in `restore_plan` are ignored and are not used to update the target RestorePlan.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "RestorePlan" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}:setIamPolicy", + "httpMethod": "POST", + "id": "gkebackup.projects.locations.restorePlans.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "SetIamPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}:testIamPermissions", + "httpMethod": "POST", + "id": "gkebackup.projects.locations.restorePlans.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "TestIamPermissionsRequest" + }, + "response": { + "$ref": "TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "restores": { + "methods": { + "create": { + "description": "Creates a new Restore for the given RestorePlan.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores", + "httpMethod": "POST", + "id": "gkebackup.projects.locations.restorePlans.restores.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The RestorePlan within which to create the Restore. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}", + "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.", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/restores", + "request": { + "$ref": "Restore" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes an existing Restore.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}", + "httpMethod": "DELETE", + "id": "gkebackup.projects.locations.restorePlans.restores.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "etag": { + "description": "etag, if provided, it must match the server's etag for delete to happen.", + "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.", + "location": "query", + "type": "boolean" + }, + "name": { + "description": "Required. Full name of the Restore Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}/restores/{restore}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Retrieves the details of a single Restore.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.restorePlans.restores.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Name of the restore resource. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}/restores/{restore}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Restore" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}:getIamPolicy", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.restorePlans.restores.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists the Restores for a given RestorePlan.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.restorePlans.restores.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "List filter.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Sort results.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "The target number of results to return in a single response. If not specified, a default value will be chosen by the service. Note that the response may inclue a partial list and a caller should only rely on the response's next_page_token to determine if there are more instances left to be queried.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The value of next_page_token received from a previous `ListRestores` call. Provide this to retrieve the subsequent page in a multi-page list of results. When paginating, all other parameters provided to `ListRestores` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The RestorePlan that contains the Restores to list. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/restores", + "response": { + "$ref": "ListRestoresResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "patch": { + "description": "Update a Restore.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}", + "httpMethod": "PATCH", + "id": "gkebackup.projects.locations.restorePlans.restores.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Output only. The full name of the Restore resource. Format: projects/*/locations/*/restorePlans/*/restores/*", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "This is used to specify the fields to be overwritten in the Restore targeted for update. The values for each of these updated fields will be taken from the `restore` provided with this request. Field names are relative to the root of the resource. If no `update_mask` is provided, all fields in `restore` will be written to the target Restore resource. Note that OUTPUT_ONLY and IMMUTABLE fields in `restore` are ignored and are not used to update the target Restore.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "Restore" + }, + "response": { + "$ref": "GoogleLongrunningOperation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}:setIamPolicy", + "httpMethod": "POST", + "id": "gkebackup.projects.locations.restorePlans.restores.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "SetIamPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}:testIamPermissions", + "httpMethod": "POST", + "id": "gkebackup.projects.locations.restorePlans.restores.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "TestIamPermissionsRequest" + }, + "response": { + "$ref": "TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + }, + "resources": { + "volumeRestores": { + "methods": { + "get": { + "description": "Retrieve the details of a single VolumeRestore.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}/volumeRestores/{volumeRestoresId}", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.restorePlans.restores.volumeRestores.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. Full name of the VolumeRestore resource. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}/restores/{restore}/volumeRestores/{volume_restore}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+/volumeRestores/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "VolumeRestore" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}/volumeRestores/{volumeRestoresId}:getIamPolicy", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.restorePlans.restores.volumeRestores.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+/volumeRestores/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Lists the VolumeRestores for a given Restore.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}/volumeRestores", + "httpMethod": "GET", + "id": "gkebackup.projects.locations.restorePlans.restores.volumeRestores.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "filter": { + "description": "List filter.", + "location": "query", + "type": "string" + }, + "orderBy": { + "description": "Sort results.", + "location": "query", + "type": "string" + }, + "pageSize": { + "description": "The target number of results to return in a single response. If not specified, a default value will be chosen by the service. Note that the response may inclue a partial list and a caller should only rely on the response's next_page_token to determine if there are more instances left to be queried.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The value of next_page_token received from a previous `ListVolumeRestores` call. Provide this to retrieve the subsequent page in a multi-page list of results. When paginating, all other parameters provided to `ListVolumeRestores` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The Restore that contains the VolumeRestores to list. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}/restores/{restore}", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/volumeRestores", + "response": { + "$ref": "ListVolumeRestoresResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}/volumeRestores/{volumeRestoresId}:setIamPolicy", + "httpMethod": "POST", + "id": "gkebackup.projects.locations.restorePlans.restores.volumeRestores.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+/volumeRestores/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:setIamPolicy", + "request": { + "$ref": "SetIamPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}/volumeRestores/{volumeRestoresId}:testIamPermissions", + "httpMethod": "POST", + "id": "gkebackup.projects.locations.restorePlans.restores.volumeRestores.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+/volumeRestores/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+resource}:testIamPermissions", + "request": { + "$ref": "TestIamPermissionsRequest" + }, + "response": { + "$ref": "TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + } + } + } + } + } + } + } + } + } + }, + "revision": "20220321", + "rootUrl": "https://gkebackup.googleapis.com/", + "schemas": { + "AuditConfig": { + "description": "Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { \"audit_configs\": [ { \"service\": \"allServices\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" }, { \"log_type\": \"ADMIN_READ\" } ] }, { \"service\": \"sampleservice.googleapis.com\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\" }, { \"log_type\": \"DATA_WRITE\", \"exempted_members\": [ \"user:aliya@example.com\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts jose@example.com from DATA_READ logging, and aliya@example.com from DATA_WRITE logging.", + "id": "AuditConfig", + "properties": { + "auditLogConfigs": { + "description": "The configuration for logging of each type of permission.", + "items": { + "$ref": "AuditLogConfig" + }, + "type": "array" + }, + "service": { + "description": "Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services.", + "type": "string" + } + }, + "type": "object" + }, + "AuditLogConfig": { + "description": "Provides the configuration for logging a type of permissions. Example: { \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.", + "id": "AuditLogConfig", + "properties": { + "exemptedMembers": { + "description": "Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members.", + "items": { + "type": "string" + }, + "type": "array" + }, + "logType": { + "description": "The log type that this config enables.", + "enum": [ + "LOG_TYPE_UNSPECIFIED", + "ADMIN_READ", + "DATA_WRITE", + "DATA_READ" + ], + "enumDescriptions": [ + "Default case. Should never be this.", + "Admin reads. Example: CloudIAM getIamPolicy", + "Data writes. Example: CloudSQL Users create", + "Data reads. Example: CloudSQL Users list" + ], + "type": "string" + } + }, + "type": "object" + }, + "Backup": { + "description": "Represents a request to perform a single point-in-time capture of some portion of the state of a GKE cluster, the record of the backup operation itself, and an anchor for the underlying artifacts that comprise the Backup (the config backup and VolumeBackups). Next id: 28", + "id": "Backup", + "properties": { + "allNamespaces": { + "description": "Output only. If True, all namespaces were included in the Backup.", + "readOnly": true, + "type": "boolean" + }, + "clusterMetadata": { + "$ref": "ClusterMetadata", + "description": "Output only. Information about the GKE cluster from which this Backup was created.", + "readOnly": true + }, + "completeTime": { + "description": "Output only. Completion time of the Backup", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "configBackupSizeBytes": { + "description": "Output only. cluster config backup size 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.", + "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.", + "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)", + "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.", + "format": "int32", + "type": "integer" + }, + "deleteLockExpireTime": { + "description": "Output only. The time at which an existing delete lock will expire for this backup (calculated from create_time + delete_lock_days).", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "User specified descriptive string for this Backup.", + "type": "string" + }, + "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.", + "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.", + "readOnly": true, + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "A set of custom labels supplied by user.", + "type": "object" + }, + "manual": { + "description": "Output only. This flag indicates whether this Backup resource was created manually by a user or via a schedule in the BackupPlan. A value of True means that the Backup was created manually.", + "readOnly": true, + "type": "boolean" + }, + "name": { + "description": "Output only. The fully qualified name of the Backup. projects/*/locations/*/backupPlans/*/backups/*", + "readOnly": true, + "type": "string" + }, + "podCount": { + "description": "Output only. The total number of Kubernetes Pods contained in the Backup.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "resourceCount": { + "description": "Output only. The total number of Kubernetes resources included in the Backup.", + "format": "int32", + "readOnly": true, + "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.", + "format": "int32", + "type": "integer" + }, + "retainExpireTime": { + "description": "Output only. The time at which this Backup will be automatically deleted (calculated from create_time + retain_days).", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "selectedApplications": { + "$ref": "NamespacedNames", + "description": "Output only. If set, the list of ProtectedApplications whose resources were included in the Backup.", + "readOnly": true + }, + "selectedNamespaces": { + "$ref": "Namespaces", + "description": "Output only. If set, the list of namespaces that were included in the Backup.", + "readOnly": true + }, + "sizeBytes": { + "description": "Output only. The total size of the Backup in bytes = config backup size + sum(volume backup sizes)", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. Current state of the Backup", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "IN_PROGRESS", + "SUCCEEDED", + "FAILED", + "DELETING" + ], + "enumDescriptions": [ + "The Backup resource is in the process of being created.", + "The Backup resource has been created and the associated BackupJob Kubernetes resource has been injected into the source cluster.", + "The gkebackup agent in the cluster has begun executing the backup operation.", + "The backup operation has completed successfully.", + "The backup operation has failed.", + "This Backup resource (and its associated artifacts) is in the process of being deleted." + ], + "readOnly": true, + "type": "string" + }, + "stateReason": { + "description": "Output only. Human-readable description of why the backup is in the current `state`.", + "readOnly": true, + "type": "string" + }, + "uid": { + "description": "Output only. [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)", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "volumeCount": { + "description": "Output only. The total number of volume backups contained in the Backup.", + "format": "int32", + "readOnly": true, + "type": "integer" + } + }, + "type": "object" + }, + "BackupConfig": { + "description": "BackupConfig defines the configuration of Backups created via this BackupPlan.", + "id": "BackupConfig", + "properties": { + "allNamespaces": { + "description": "If True, include all namespaced resources", + "type": "boolean" + }, + "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." + }, + "includeSecrets": { + "description": "This flag specifies whether Kubernetes Secret resources should be included when they fall into the scope of Backups. Default: False", + "type": "boolean" + }, + "includeVolumeData": { + "description": "This flag specifies whether volume data should be backed up when PVCs are included in the scope of a Backup. Default: False", + "type": "boolean" + }, + "selectedApplications": { + "$ref": "NamespacedNames", + "description": "If set, include just the resources referenced by the listed ProtectedApplications." + }, + "selectedNamespaces": { + "$ref": "Namespaces", + "description": "If set, include just the resources in the listed namespaces" + } + }, + "type": "object" + }, + "BackupPlan": { + "description": "Defines the configuration and scheduling for a \"line\" of Backups.", + "id": "BackupPlan", + "properties": { + "backupConfig": { + "$ref": "BackupConfig", + "description": "Defines the configuration of Backups created via this BackupPlan." + }, + "backupSchedule": { + "$ref": "Schedule", + "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/*", + "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)", + "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", + "type": "boolean" + }, + "description": { + "description": "User specified descriptive string for this BackupPlan.", + "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.", + "readOnly": true, + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "A set of custom labels supplied by user.", + "type": "object" + }, + "name": { + "description": "Output only. [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.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "retentionPolicy": { + "$ref": "RetentionPolicy", + "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.", + "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)", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "Binding": { + "description": "Associates `members`, or principals, with a `role`.", + "id": "Binding", + "properties": { + "condition": { + "$ref": "Expr", + "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`. ", + "items": { + "type": "string" + }, + "type": "array" + }, + "role": { + "description": "Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`.", + "type": "string" + } + }, + "type": "object" + }, + "ClusterMetadata": { + "description": "Information about the GKE cluster from which this Backup was created.", + "id": "ClusterMetadata", + "properties": { + "anthosVersion": { + "description": "Anthos version", + "type": "string" + }, + "backupCrdVersions": { + "additionalProperties": { + "type": "string" + }, + "description": "A list of the Backup for GKE CRD versions found in the cluster.", + "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.", + "type": "string" + }, + "gkeVersion": { + "description": "GKE version", + "type": "string" + }, + "k8sVersion": { + "description": "The Kubernetes server version of the source cluster.", + "type": "string" + } + }, + "type": "object" + }, + "ClusterResourceRestoreScope": { + "description": "Identifies the cluster-scoped resources to restore from the Backup.", + "id": "ClusterResourceRestoreScope", + "properties": { + "selectedGroupKinds": { + "description": "A list of \"types\" of cluster-scoped resources to be restored from the Backup. An empty list means that NO cluster-scoped resources will be restored. Note that Namespaces and PersistentVolume restoration is handled separately and is not governed by this field.", + "items": { + "$ref": "GroupKind" + }, + "type": "array" + } + }, + "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", + "properties": {}, + "type": "object" + }, + "EncryptionKey": { + "description": "Defined a customer managed encryption key that will be used to encrypt Backup artifacts.", + "id": "EncryptionKey", + "properties": { + "gcpKmsEncryptionKey": { + "description": "Google Cloud KMS encryption key. Format: projects//locations//keyRings//cryptoKeys/", + "type": "string" + } + }, + "type": "object" + }, + "Expr": { + "description": "Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: \"Summary size limit\" description: \"Determines if a summary is less than 100 chars\" expression: \"document.summary.size() \u003c 100\" Example (Equality): title: \"Requestor is owner\" description: \"Determines if requestor is the document owner\" expression: \"document.owner == request.auth.claims.email\" Example (Logic): title: \"Public documents\" description: \"Determine whether the document should be publicly visible\" expression: \"document.type != 'private' \u0026\u0026 document.type != 'internal'\" Example (Data Manipulation): title: \"Notification string\" description: \"Create a notification string with a timestamp.\" expression: \"'New message received at ' + string(document.create_time)\" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.", + "id": "Expr", + "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" + }, + "GoogleLongrunningCancelOperationRequest": { + "description": "The request message for Operations.CancelOperation.", + "id": "GoogleLongrunningCancelOperationRequest", + "properties": {}, + "type": "object" + }, + "GoogleLongrunningListOperationsResponse": { + "description": "The response message for Operations.ListOperations.", + "id": "GoogleLongrunningListOperationsResponse", + "properties": { + "nextPageToken": { + "description": "The standard List next-page token.", + "type": "string" + }, + "operations": { + "description": "A list of operations that matches the specified filter in the request.", + "items": { + "$ref": "GoogleLongrunningOperation" + }, + "type": "array" + } + }, + "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" + }, + "GroupKind": { + "description": "This is a direct map to the Kubernetes GroupKind type [GroupKind](https://godoc.org/k8s.io/apimachinery/pkg/runtime/schema#GroupKind) and is used for identifying specific \"types\" of resources to restore.", + "id": "GroupKind", + "properties": { + "resourceGroup": { + "description": "API group string of a Kubernetes resource, e.g. \"apiextensions.k8s.io\", \"storage.k8s.io\", etc. Note: use empty string for core API group", + "type": "string" + }, + "resourceKind": { + "description": "Kind of a Kubernetes resource, e.g. \"CustomResourceDefinition\", \"StorageClass\", etc.", + "type": "string" + } + }, + "type": "object" + }, + "ListBackupPlansResponse": { + "description": "Response message for ListBackupPlans.", + "id": "ListBackupPlansResponse", + "properties": { + "backupPlans": { + "description": "The list of BackupPlans.", + "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.", + "type": "string" + }, + "unreachable": { + "description": "Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListBackupsResponse": { + "description": "Response message for ListBackups.", + "id": "ListBackupsResponse", + "properties": { + "backups": { + "description": "The list of restore resources within the parent.", + "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.", + "type": "string" + } + }, + "type": "object" + }, + "ListLocationsResponse": { + "description": "The response message for Locations.ListLocations.", + "id": "ListLocationsResponse", + "properties": { + "locations": { + "description": "A list of locations that matches the specified filter in the request.", + "items": { + "$ref": "Location" + }, + "type": "array" + }, + "nextPageToken": { + "description": "The standard List next-page token.", + "type": "string" + } + }, + "type": "object" + }, + "ListRestorePlansResponse": { + "description": "Response message for ListRestorePlans.", + "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.", + "type": "string" + }, + "restorePlans": { + "description": "The list of RestorePlans.", + "items": { + "$ref": "RestorePlan" + }, + "type": "array" + }, + "unreachable": { + "description": "Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListRestoresResponse": { + "description": "Response message for ListRestores.", + "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.", + "type": "string" + }, + "restores": { + "description": "The list of restore resources within the parent.", + "items": { + "$ref": "Restore" + }, + "type": "array" + }, + "unreachable": { + "description": "Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListVolumeBackupsResponse": { + "description": "Response message for ListVolumeBackups.", + "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.", + "type": "string" + }, + "volumeBackups": { + "description": "The list of VolumeBackups resources within the parent.", + "items": { + "$ref": "VolumeBackup" + }, + "type": "array" + } + }, + "type": "object" + }, + "ListVolumeRestoresResponse": { + "description": "Response message for ListVolumeRestores.", + "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.", + "type": "string" + }, + "volumeRestores": { + "description": "The list of VolumeRestores resources within the parent.", + "items": { + "$ref": "VolumeRestore" + }, + "type": "array" + } + }, + "type": "object" + }, + "Location": { + "description": "A resource that represents Google Cloud Platform location.", + "id": "Location", + "properties": { + "displayName": { + "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\".", + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}", + "type": "object" + }, + "locationId": { + "description": "The canonical id for this location. For example: `\"us-east1\"`.", + "type": "string" + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "Service-specific metadata. For example the available capacity at the given location.", + "type": "object" + }, + "name": { + "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`", + "type": "string" + } + }, + "type": "object" + }, + "NamespacedName": { + "description": "A reference to a namespaced resource in Kubernetes.", + "id": "NamespacedName", + "properties": { + "name": { + "description": "The name of the Kubernetes resource.", + "type": "string" + }, + "namespace": { + "description": "The Namespace of the Kubernetes resource.", + "type": "string" + } + }, + "type": "object" + }, + "NamespacedNames": { + "description": "A list of namespaced Kubernetes resources.", + "id": "NamespacedNames", + "properties": { + "namespacedNames": { + "description": "A list of namespaced Kubernetes resources.", + "items": { + "$ref": "NamespacedName" + }, + "type": "array" + } + }, + "type": "object" + }, + "Namespaces": { + "description": "A list of Kubernetes Namespaces", + "id": "Namespaces", + "properties": { + "namespaces": { + "description": "A list of Kubernetes Namespaces", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "OperationMetadata": { + "description": "Represents the metadata of the long-running operation.", + "id": "OperationMetadata", + "properties": { + "apiVersion": { + "description": "Output only. API version used to start the operation.", + "readOnly": true, + "type": "string" + }, + "createTime": { + "description": "Output only. The time the operation was created.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "endTime": { + "description": "Output only. The time the operation finished running.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "requestedCancellation": { + "description": "Output only. Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + "readOnly": true, + "type": "boolean" + }, + "statusMessage": { + "description": "Output only. Human-readable status of the operation, if any.", + "readOnly": true, + "type": "string" + }, + "target": { + "description": "Output only. Server-defined resource path for the target of the operation.", + "readOnly": true, + "type": "string" + }, + "verb": { + "description": "Output only. Name of the verb executed by the operation.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "Policy": { + "description": "An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** { \"bindings\": [ { \"role\": \"roles/resourcemanager.organizationAdmin\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-project-id@appspot.gserviceaccount.com\" ] }, { \"role\": \"roles/resourcemanager.organizationViewer\", \"members\": [ \"user:eve@example.com\" ], \"condition\": { \"title\": \"expirable access\", \"description\": \"Does not grant access after Sep 2020\", \"expression\": \"request.time \u003c timestamp('2020-10-01T00:00:00.000Z')\", } } ], \"etag\": \"BwWWja0YfJA=\", \"version\": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time \u003c timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).", + "id": "Policy", + "properties": { + "auditConfigs": { + "description": "Specifies cloud audit logging configuration for this policy.", + "items": { + "$ref": "AuditConfig" + }, + "type": "array" + }, + "bindings": { + "description": "Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.", + "items": { + "$ref": "Binding" + }, + "type": "array" + }, + "etag": { + "description": "`etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.", + "format": "byte", + "type": "string" + }, + "version": { + "description": "Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "Restore": { + "description": "Represents both a request to Restore some portion of a Backup into a target GKE cluster and a record of the restore operation itself. Next id: 18", + "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/*.", + "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.", + "readOnly": true, + "type": "string" + }, + "completeTime": { + "description": "Output only. When the restore operation either successfully completed or failed.", + "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)", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "User specified descriptive string for this Restore.", + "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.", + "readOnly": true, + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "GCP Labels.", + "type": "object" + }, + "name": { + "description": "Output only. The full name of the Restore resource. Format: projects/*/locations/*/restorePlans/*/restores/*", + "readOnly": true, + "type": "string" + }, + "resourcesExcludedCount": { + "description": "Output only. Number of resources excluded in this restore action.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "resourcesFailedCount": { + "description": "Output only. Number of resources failed to be restored in this restore action.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "resourcesRestoredCount": { + "description": "Output only. Number of resources restored in this restore action.", + "format": "int32", + "readOnly": true, + "type": "integer" + }, + "restoreConfig": { + "$ref": "RestoreConfig", + "description": "Output only. Configuration of the Restore. Inherited from parent RestorePlan's restore_config.", + "readOnly": true + }, + "state": { + "description": "Output only. The current state of the Restore.", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "IN_PROGRESS", + "SUCCEEDED", + "FAILED", + "DELETING" + ], + "enumDescriptions": [ + "The Restore resource is in the process of being created.", + "The Restore resource has been created and the associated RestoreJob Kubernetes resource has been injected into target cluster.", + "The gkebackup agent in the cluster has begun executing the restore operation.", + "The restore operation has completed successfully. Restored workloads may not yet be operational.", + "The restore operation has failed.", + "This Restore resource is in the process of being deleted." + ], + "readOnly": true, + "type": "string" + }, + "stateReason": { + "description": "Output only. Human-readable description of why the Restore is in its current state.", + "readOnly": true, + "type": "string" + }, + "uid": { + "description": "Output only. [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)", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "volumesRestoredCount": { + "description": "Output only. Number of volumes restored in this restore action.", + "format": "int32", + "readOnly": true, + "type": "integer" + } + }, + "type": "object" + }, + "RestoreConfig": { + "description": "Configuration of a restore. Next id: 9", + "id": "RestoreConfig", + "properties": { + "allNamespaces": { + "description": "Restore all namespaced resources in the Backup if set to \"True\". Specifying this field to \"False\" is an error.", + "type": "boolean" + }, + "clusterResourceConflictPolicy": { + "description": "Defines the behavior for handling the situation where cluster-scoped resources being restored already exist in the target cluster. This MUST be set to a value other than CLUSTER_RESOURCE_CONFLICT_POLICY_UNSPECIFIED if cluster_resource_restore_scope is not empty.", + "enum": [ + "CLUSTER_RESOURCE_CONFLICT_POLICY_UNSPECIFIED", + "USE_EXISTING_VERSION", + "USE_BACKUP_VERSION" + ], + "enumDescriptions": [ + "Unspecified. Only allowed if no cluster-scoped resources will be restored.", + "Do not attempt to restore the conflicting resource.", + "Delete the existing version before re-creating it from the Backup. Note that this is a dangerous option which could cause unintentional data loss if used inappropriately - for example, deleting a CRD will cause Kubernetes to delete all CRs of that type." + ], + "type": "string" + }, + "clusterResourceRestoreScope": { + "$ref": "ClusterResourceRestoreScope", + "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 .", + "enum": [ + "NAMESPACED_RESOURCE_RESTORE_MODE_UNSPECIFIED", + "DELETE_AND_RESTORE", + "FAIL_ON_CONFLICT" + ], + "enumDescriptions": [ + "Unspecified. Only allowed if no namespaced resources will be restored.", + "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." + ], + "type": "string" + }, + "selectedApplications": { + "$ref": "NamespacedNames", + "description": "A list of selected ProtectedApplications to restore. The listed ProtectedApplications and all the resources to which they refer will be restored." + }, + "selectedNamespaces": { + "$ref": "Namespaces", + "description": "A list of selected Namespaces to restore from the Backup. The listed Namespaces and all resources contained in them will be restored." + }, + "substitutionRules": { + "description": "A list of transformation rules to be applied against Kubernetes resources as they are selected for restoration from a Backup. Rules are executed in order defined - this order matters, as changes made by a rule may impact the filtering logic of subsequent rules. An empty list means no substitution will occur.", + "items": { + "$ref": "SubstitutionRule" + }, + "type": "array" + }, + "volumeDataRestorePolicy": { + "description": "Specifies the mechanism to be used to restore volume data. Default: VOLUME_DATA_RESTORE_POLICY_UNSPECIFIED (will be treated as NO_VOLUME_DATA_RESTORATION).", + "enum": [ + "VOLUME_DATA_RESTORE_POLICY_UNSPECIFIED", + "RESTORE_VOLUME_DATA_FROM_BACKUP", + "REUSE_VOLUME_HANDLE_FROM_BACKUP", + "NO_VOLUME_DATA_RESTORATION" + ], + "enumDescriptions": [ + "unspecified, default value", + "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." + ], + "type": "string" + } + }, + "type": "object" + }, + "RestorePlan": { + "description": "The configuration of a potential series of Restore operations to be performed against Backups belong to a particular BackupPlan. Next id: 11", + "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/*.", + "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/*", + "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)", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "User specified descriptive string for this RestorePlan.", + "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.", + "readOnly": true, + "type": "string" + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "A set of custom labels supplied by user.", + "type": "object" + }, + "name": { + "description": "Output only. [Output Only] The full name of the RestorePlan resource. Format: projects/*/locations/*/restorePlans/*", + "readOnly": true, + "type": "string" + }, + "restoreConfig": { + "$ref": "RestoreConfig", + "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.", + "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)", + "format": "google-datetime", + "readOnly": true, + "type": "string" + } + }, + "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", + "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)", + "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)", + "format": "int32", + "type": "integer" + }, + "locked": { + "description": "This flag denotes whether the retention policy of this BackupPlan is locked. If set to True, no further update is allowed on this policy, including the `locked` field itself. Default: False", + "type": "boolean" + } + }, + "type": "object" + }, + "Schedule": { + "description": "Schedule defines scheduling parameters for automatically creating Backups via this BackupPlan.", + "id": "Schedule", + "properties": { + "cronSchedule": { + "description": "A standard cron-style string that defines a repeating schedule for creating Backups via this BackupPlan.", + "type": "string" + }, + "paused": { + "description": "This flag denotes whether automatic Backup creation is paused for this BackupPlan. Default: False", + "type": "boolean" + } + }, + "type": "object" + }, + "SetIamPolicyRequest": { + "description": "Request message for `SetIamPolicy` method.", + "id": "SetIamPolicyRequest", + "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." + }, + "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\"`", + "format": "google-fieldmask", + "type": "string" + } + }, + "type": "object" + }, + "SubstitutionRule": { + "description": "A transformation rule to be applied against Kubernetes resources as they are selected for restoration from a Backup. A rule contains both filtering logic (which resources are subject to substitution) and substitution logic.", + "id": "SubstitutionRule", + "properties": { + "newValue": { + "description": "This is the new value to set for any fields that pass the filtering and selection criteria. To remove a value from a Kubernetes resource, either leave this field unspecified, or set it to the empty string (\"\").", + "type": "string" + }, + "originalValuePattern": { + "description": "(Filtering parameter) This is a [regular expression] (https://en.wikipedia.org/wiki/Regular_expression) that is compared against the fields matched by the target_json_path expression (and must also have passed the previous filters). Substitution will not be performed against fields whose value does not match this expression. If this field is NOT specified, then ALL fields matched by the target_json_path expression will undergo substitution. Note that an empty (e.g., \"\", rather than unspecified) value for for this field will only match empty fields.", + "type": "string" + }, + "targetGroupKinds": { + "description": "(Filtering parameter) Any resource subject to substitution must belong to one of the listed \"types\". If this field is not provided, no type filtering will be performed (all resources of all types matching previous filtering parameters will be candidates for substitution).", + "items": { + "$ref": "GroupKind" + }, + "type": "array" + }, + "targetJsonPath": { + "description": "Required. This is a [JSONPath] (https://kubernetes.io/docs/reference/kubectl/jsonpath/) expression that matches specific fields of candidate resources and it operates as both a filtering parameter (resources that are not matched with this expression will not be candidates for substitution) as well as a field identifier (identifies exactly which fields out of the candidate resources will be modified).", + "type": "string" + }, + "targetNamespaces": { + "description": "(Filtering parameter) Any resource subject to substitution must be contained within one of the listed Kubernetes Namespace in the Backup. If this field is not provided, no namespace filtering will be performed (all resources in all Namespaces, including all cluster-scoped resources, will be candidates for substitution). To mix cluster-scoped and namespaced resources in the same rule, use an empty string (\"\") as one of the target namespaces.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "TestIamPermissionsRequest": { + "description": "Request message for `TestIamPermissions` method.", + "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).", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "TestIamPermissionsResponse": { + "description": "Response message for `TestIamPermissions` method.", + "id": "TestIamPermissionsResponse", + "properties": { + "permissions": { + "description": "A subset of `TestPermissionsRequest.permissions` that the caller is allowed.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "VolumeBackup": { + "description": "Represents the backup of a specific persistent volume as a component of a Backup - both the record of the operation and a pointer to the underlying storage-specific artifacts. Next id: 14", + "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)", + "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)", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "diskSizeBytes": { + "description": "Output only. The minimum size of the disk to which this VolumeBackup can be restored.", + "format": "int64", + "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 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.", + "readOnly": true, + "type": "string" + }, + "format": { + "description": "Output only. The format used for the volume backup.", + "enum": [ + "VOLUME_BACKUP_FORMAT_UNSPECIFIED", + "GCE_PERSISTENT_DISK" + ], + "enumDescriptions": [ + "Default value, not specified.", + "Compute Engine Persistent Disk snapshot based volume backup." + ], + "readOnly": true, + "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-'.", + "readOnly": true, + "type": "string" + }, + "sourcePvc": { + "$ref": "NamespacedName", + "description": "Output only. A reference to the source Kubernetes PVC from which this VolumeBackup was created.", + "readOnly": true + }, + "state": { + "description": "Output only. The current state of this VolumeBackup.", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "SNAPSHOTTING", + "UPLOADING", + "SUCCEEDED", + "FAILED", + "DELETING" + ], + "enumDescriptions": [ + "This is an illegal state and should not be encountered.", + "A volume for the backup was identified and backup process is about to start.", + "The volume backup operation has begun and is in the initial \"snapshot\" phase of the process. Any defined ProtectedApplication \"pre\" hooks will be executed before entering this state and \"post\" hooks will be executed upon leaving this state.", + "The snapshot phase of the volume backup operation has completed and the snapshot is now being uploaded to backup storage.", + "The volume backup operation has completed successfully.", + "The volume backup operation has failed.", + "This VolumeBackup resource (and its associated artifacts) is in the process of being deleted." + ], + "readOnly": true, + "type": "string" + }, + "stateMessage": { + "description": "Output only. A human readable message explaining why the VolumeBackup is in its current state.", + "readOnly": true, + "type": "string" + }, + "storageBytes": { + "description": "Output only. The aggregate size of the underlying artifacts associated with this VolumeBackup in the backup storage. This may change over time when multiple backups of the same volume share the same backup storage location. In particular, this is likely to increase in size when the immediately preceding backup of the same volume is deleted.", + "format": "int64", + "readOnly": true, + "type": "string" + }, + "uid": { + "description": "Output only. [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)", + "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.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, + "VolumeRestore": { + "description": "Represents the operation of restoring a volume from a VolumeBackup. Next id: 13", + "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)", + "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)", + "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.", + "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-'.", + "readOnly": true, + "type": "string" + }, + "state": { + "description": "Output only. The current state of this VolumeRestore", + "enum": [ + "STATE_UNSPECIFIED", + "CREATING", + "RESTORING", + "SUCCEEDED", + "FAILED", + "DELETING" + ], + "enumDescriptions": [ + "This is an illegal state and should not be encountered.", + "A volume for the restore was identified and restore process is about to start.", + "The volume is currently being restored.", + "The volume has been successfully restored.", + "The volume restoration process failed.", + "This VolumeRestore resource is in the process of being deleted." + ], + "readOnly": true, + "type": "string" + }, + "stateMessage": { + "description": "Output only. A human readable message explaining why the VolumeRestore is in its current state.", + "readOnly": true, + "type": "string" + }, + "targetPvc": { + "$ref": "NamespacedName", + "description": "Output only. The reference to the target Kubernetes PVC to be restored.", + "readOnly": true + }, + "uid": { + "description": "Output only. [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)", + "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/*", + "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.", + "readOnly": true, + "type": "string" + }, + "volumeType": { + "description": "Output only. The type of volume provisioned", + "enum": [ + "VOLUME_TYPE_UNSPECIFIED", + "GCE_PERSISTENT_DISK" + ], + "enumDescriptions": [ + "Default", + "Compute Engine Persistent Disk volume" + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" + } + }, + "servicePath": "", + "title": "Backup for GKE API", + "version": "v1", + "version_module": true +} \ No newline at end of file diff --git a/gkebackup/v1/gkebackup-gen.go b/gkebackup/v1/gkebackup-gen.go new file mode 100644 index 00000000000..e5732546941 --- /dev/null +++ b/gkebackup/v1/gkebackup-gen.go @@ -0,0 +1,10435 @@ +// 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 gkebackup provides access to the Backup for GKE API. +// +// For product documentation, see: https://cloud.google.com/kubernetes-engine/docs/add-on/backup-for-gke +// +// Creating a client +// +// Usage example: +// +// import "google.golang.org/api/gkebackup/v1" +// ... +// ctx := context.Background() +// gkebackupService, err := gkebackup.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: +// +// gkebackupService, err := gkebackup.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, ...) +// gkebackupService, err := gkebackup.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token))) +// +// See https://godoc.org/google.golang.org/api/option/ for details on options. +package gkebackup // import "google.golang.org/api/gkebackup/v1" + +import ( + "bytes" + "context" + "encoding/json" + "errors" + "fmt" + "io" + "net/http" + "net/url" + "strconv" + "strings" + + googleapi "google.golang.org/api/googleapi" + internal "google.golang.org/api/internal" + gensupport "google.golang.org/api/internal/gensupport" + option "google.golang.org/api/option" + internaloption "google.golang.org/api/option/internaloption" + htransport "google.golang.org/api/transport/http" +) + +// Always reference these packages, just in case the auto-generated code +// below doesn't. +var _ = bytes.NewBuffer +var _ = strconv.Itoa +var _ = fmt.Sprintf +var _ = json.NewDecoder +var _ = io.Copy +var _ = url.Parse +var _ = gensupport.MarshalJSON +var _ = googleapi.Version +var _ = errors.New +var _ = strings.Replace +var _ = context.Canceled +var _ = internaloption.WithDefaultEndpoint + +const apiId = "gkebackup:v1" +const apiName = "gkebackup" +const apiVersion = "v1" +const basePath = "https://gkebackup.googleapis.com/" +const mtlsBasePath = "https://gkebackup.mtls.googleapis.com/" + +// OAuth2 scopes used by this API. +const ( + // See, edit, configure, and delete your Google Cloud data and see the + // email address for your Google Account. + CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform" +) + +// NewService creates a new Service. +func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error) { + scopesOption := internaloption.WithDefaultScopes( + "https://www.googleapis.com/auth/cloud-platform", + ) + // NOTE: prepend, so we don't override user-specified scopes. + opts = append([]option.ClientOption{scopesOption}, opts...) + opts = append(opts, internaloption.WithDefaultEndpoint(basePath)) + opts = append(opts, internaloption.WithDefaultMTLSEndpoint(mtlsBasePath)) + client, endpoint, err := htransport.NewClient(ctx, opts...) + if err != nil { + return nil, err + } + s, err := New(client) + if err != nil { + return nil, err + } + if endpoint != "" { + s.BasePath = endpoint + } + return s, nil +} + +// New creates a new Service. It uses the provided http.Client for requests. +// +// Deprecated: please use NewService instead. +// To provide a custom HTTP client, use option.WithHTTPClient. +// If you are using google.golang.org/api/googleapis/transport.APIKey, use option.WithAPIKey with NewService instead. +func New(client *http.Client) (*Service, error) { + if client == nil { + return nil, errors.New("client is nil") + } + s := &Service{client: client, BasePath: basePath} + s.Projects = NewProjectsService(s) + return s, nil +} + +type Service struct { + client *http.Client + BasePath string // API endpoint base URL + UserAgent string // optional additional User-Agent fragment + + Projects *ProjectsService +} + +func (s *Service) userAgent() string { + if s.UserAgent == "" { + return googleapi.UserAgent + } + return googleapi.UserAgent + " " + s.UserAgent +} + +func NewProjectsService(s *Service) *ProjectsService { + rs := &ProjectsService{s: s} + rs.Locations = NewProjectsLocationsService(s) + return rs +} + +type ProjectsService struct { + s *Service + + Locations *ProjectsLocationsService +} + +func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { + rs := &ProjectsLocationsService{s: s} + rs.BackupPlans = NewProjectsLocationsBackupPlansService(s) + rs.Operations = NewProjectsLocationsOperationsService(s) + rs.RestorePlans = NewProjectsLocationsRestorePlansService(s) + return rs +} + +type ProjectsLocationsService struct { + s *Service + + BackupPlans *ProjectsLocationsBackupPlansService + + Operations *ProjectsLocationsOperationsService + + RestorePlans *ProjectsLocationsRestorePlansService +} + +func NewProjectsLocationsBackupPlansService(s *Service) *ProjectsLocationsBackupPlansService { + rs := &ProjectsLocationsBackupPlansService{s: s} + rs.Backups = NewProjectsLocationsBackupPlansBackupsService(s) + return rs +} + +type ProjectsLocationsBackupPlansService struct { + s *Service + + Backups *ProjectsLocationsBackupPlansBackupsService +} + +func NewProjectsLocationsBackupPlansBackupsService(s *Service) *ProjectsLocationsBackupPlansBackupsService { + rs := &ProjectsLocationsBackupPlansBackupsService{s: s} + rs.VolumeBackups = NewProjectsLocationsBackupPlansBackupsVolumeBackupsService(s) + return rs +} + +type ProjectsLocationsBackupPlansBackupsService struct { + s *Service + + VolumeBackups *ProjectsLocationsBackupPlansBackupsVolumeBackupsService +} + +func NewProjectsLocationsBackupPlansBackupsVolumeBackupsService(s *Service) *ProjectsLocationsBackupPlansBackupsVolumeBackupsService { + rs := &ProjectsLocationsBackupPlansBackupsVolumeBackupsService{s: s} + return rs +} + +type ProjectsLocationsBackupPlansBackupsVolumeBackupsService struct { + s *Service +} + +func NewProjectsLocationsOperationsService(s *Service) *ProjectsLocationsOperationsService { + rs := &ProjectsLocationsOperationsService{s: s} + return rs +} + +type ProjectsLocationsOperationsService struct { + s *Service +} + +func NewProjectsLocationsRestorePlansService(s *Service) *ProjectsLocationsRestorePlansService { + rs := &ProjectsLocationsRestorePlansService{s: s} + rs.Restores = NewProjectsLocationsRestorePlansRestoresService(s) + return rs +} + +type ProjectsLocationsRestorePlansService struct { + s *Service + + Restores *ProjectsLocationsRestorePlansRestoresService +} + +func NewProjectsLocationsRestorePlansRestoresService(s *Service) *ProjectsLocationsRestorePlansRestoresService { + rs := &ProjectsLocationsRestorePlansRestoresService{s: s} + rs.VolumeRestores = NewProjectsLocationsRestorePlansRestoresVolumeRestoresService(s) + return rs +} + +type ProjectsLocationsRestorePlansRestoresService struct { + s *Service + + VolumeRestores *ProjectsLocationsRestorePlansRestoresVolumeRestoresService +} + +func NewProjectsLocationsRestorePlansRestoresVolumeRestoresService(s *Service) *ProjectsLocationsRestorePlansRestoresVolumeRestoresService { + rs := &ProjectsLocationsRestorePlansRestoresVolumeRestoresService{s: s} + return rs +} + +type ProjectsLocationsRestorePlansRestoresVolumeRestoresService struct { + s *Service +} + +// AuditConfig: Specifies the audit configuration for a service. The +// configuration determines which permission types are logged, and what +// identities, if any, are exempted from logging. An AuditConfig must +// have one or more AuditLogConfigs. If there are AuditConfigs for both +// `allServices` and a specific service, the union of the two +// AuditConfigs is used for that service: the log_types specified in +// each AuditConfig are enabled, and the exempted_members in each +// AuditLogConfig are exempted. Example Policy with multiple +// AuditConfigs: { "audit_configs": [ { "service": "allServices", +// "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": +// [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" }, { +// "log_type": "ADMIN_READ" } ] }, { "service": +// "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": +// "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ +// "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy +// enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts +// jose@example.com from DATA_READ logging, and aliya@example.com from +// DATA_WRITE logging. +type AuditConfig struct { + // AuditLogConfigs: The configuration for logging of each type of + // permission. + AuditLogConfigs []*AuditLogConfig `json:"auditLogConfigs,omitempty"` + + // Service: Specifies a service that will be enabled for audit logging. + // For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. + // `allServices` is a special value that covers all services. + Service string `json:"service,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AuditLogConfigs") 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. "AuditLogConfigs") 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 *AuditConfig) MarshalJSON() ([]byte, error) { + type NoMethod AuditConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// AuditLogConfig: Provides the configuration for logging a type of +// permissions. Example: { "audit_log_configs": [ { "log_type": +// "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { +// "log_type": "DATA_WRITE" } ] } This enables 'DATA_READ' and +// 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ +// logging. +type AuditLogConfig struct { + // ExemptedMembers: Specifies the identities that do not cause logging + // for this type of permission. Follows the same format of + // Binding.members. + ExemptedMembers []string `json:"exemptedMembers,omitempty"` + + // LogType: The log type that this config enables. + // + // Possible values: + // "LOG_TYPE_UNSPECIFIED" - Default case. Should never be this. + // "ADMIN_READ" - Admin reads. Example: CloudIAM getIamPolicy + // "DATA_WRITE" - Data writes. Example: CloudSQL Users create + // "DATA_READ" - Data reads. Example: CloudSQL Users list + LogType string `json:"logType,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ExemptedMembers") 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. "ExemptedMembers") 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 *AuditLogConfig) MarshalJSON() ([]byte, error) { + type NoMethod AuditLogConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// Backup: Represents a request to perform a single point-in-time +// capture of some portion of the state of a GKE cluster, the record of +// the backup operation itself, and an anchor for the underlying +// artifacts that comprise the Backup (the config backup and +// VolumeBackups). Next id: 28 +type Backup struct { + // AllNamespaces: Output only. If True, all namespaces were included in + // the Backup. + AllNamespaces bool `json:"allNamespaces,omitempty"` + + // ClusterMetadata: Output only. Information about the GKE cluster from + // which this Backup was created. + ClusterMetadata *ClusterMetadata `json:"clusterMetadata,omitempty"` + + // CompleteTime: Output only. Completion time of the Backup + CompleteTime string `json:"completeTime,omitempty"` + + // ConfigBackupSizeBytes: Output only. cluster config backup size 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. + 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. + 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 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. + DeleteLockDays int64 `json:"deleteLockDays,omitempty"` + + // DeleteLockExpireTime: Output only. The time at which an existing + // delete lock will expire for this backup (calculated from create_time + // + delete_lock_days). + DeleteLockExpireTime string `json:"deleteLockExpireTime,omitempty"` + + // Description: User specified descriptive string for this Backup. + Description string `json:"description,omitempty"` + + // 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. + EncryptionKey *EncryptionKey `json:"encryptionKey,omitempty"` + + // Etag: 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. + Etag string `json:"etag,omitempty"` + + // Labels: A set of custom labels supplied by user. + Labels map[string]string `json:"labels,omitempty"` + + // Manual: Output only. This flag indicates whether this Backup resource + // was created manually by a user or via a schedule in the BackupPlan. A + // value of True means that the Backup was created manually. + Manual bool `json:"manual,omitempty"` + + // Name: Output only. The fully qualified name of the Backup. + // projects/*/locations/*/backupPlans/*/backups/* + Name string `json:"name,omitempty"` + + // PodCount: Output only. The total number of Kubernetes Pods contained + // in the Backup. + PodCount int64 `json:"podCount,omitempty"` + + // ResourceCount: Output only. The total number of Kubernetes resources + // included in the Backup. + 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. + RetainDays int64 `json:"retainDays,omitempty"` + + // RetainExpireTime: Output only. The time at which this Backup will be + // automatically deleted (calculated from create_time + retain_days). + RetainExpireTime string `json:"retainExpireTime,omitempty"` + + // SelectedApplications: Output only. If set, the list of + // ProtectedApplications whose resources were included in the Backup. + SelectedApplications *NamespacedNames `json:"selectedApplications,omitempty"` + + // SelectedNamespaces: Output only. If set, the list of namespaces that + // were included in the Backup. + SelectedNamespaces *Namespaces `json:"selectedNamespaces,omitempty"` + + // SizeBytes: Output only. The total size of the Backup in bytes = + // config backup size + sum(volume backup sizes) + SizeBytes int64 `json:"sizeBytes,omitempty,string"` + + // State: Output only. Current state of the Backup + // + // Possible values: + // "STATE_UNSPECIFIED" - The Backup resource is in the process of + // being created. + // "CREATING" - The Backup resource has been created and the + // associated BackupJob Kubernetes resource has been injected into the + // source cluster. + // "IN_PROGRESS" - The gkebackup agent in the cluster has begun + // executing the backup operation. + // "SUCCEEDED" - The backup operation has completed successfully. + // "FAILED" - The backup operation has failed. + // "DELETING" - This Backup resource (and its associated artifacts) is + // in the process of being deleted. + State string `json:"state,omitempty"` + + // StateReason: Output only. Human-readable description of why the + // backup is in the current `state`. + StateReason string `json:"stateReason,omitempty"` + + // Uid: Output only. [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 string `json:"updateTime,omitempty"` + + // VolumeCount: Output only. The total number of volume backups + // contained in the Backup. + VolumeCount int64 `json:"volumeCount,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "AllNamespaces") 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. "AllNamespaces") 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 *Backup) MarshalJSON() ([]byte, error) { + type NoMethod Backup + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BackupConfig: BackupConfig defines the configuration of Backups +// created via this BackupPlan. +type BackupConfig struct { + // AllNamespaces: If True, include all namespaced resources + 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. + EncryptionKey *EncryptionKey `json:"encryptionKey,omitempty"` + + // IncludeSecrets: This flag specifies whether Kubernetes Secret + // resources should be included when they fall into the scope of + // Backups. Default: False + IncludeSecrets bool `json:"includeSecrets,omitempty"` + + // IncludeVolumeData: This flag specifies whether volume data should be + // backed up when PVCs are included in the scope of a Backup. Default: + // False + IncludeVolumeData bool `json:"includeVolumeData,omitempty"` + + // SelectedApplications: If set, include just the resources referenced + // by the listed ProtectedApplications. + SelectedApplications *NamespacedNames `json:"selectedApplications,omitempty"` + + // SelectedNamespaces: If set, include just the resources in the listed + // namespaces + SelectedNamespaces *Namespaces `json:"selectedNamespaces,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AllNamespaces") 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. "AllNamespaces") 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 *BackupConfig) MarshalJSON() ([]byte, error) { + type NoMethod BackupConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// BackupPlan: Defines the configuration and scheduling for a "line" of +// Backups. +type BackupPlan struct { + // BackupConfig: Defines the configuration of Backups created via this + // BackupPlan. + BackupConfig *BackupConfig `json:"backupConfig,omitempty"` + + // BackupSchedule: Defines a schedule for automatic Backup creation via + // this BackupPlan. + 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/* + 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 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 + Deactivated bool `json:"deactivated,omitempty"` + + // Description: User specified descriptive string for this BackupPlan. + Description string `json:"description,omitempty"` + + // Etag: 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. + 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 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 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 + // (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 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. "BackupConfig") 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. "BackupConfig") 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 *BackupPlan) MarshalJSON() ([]byte, error) { + type NoMethod BackupPlan + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// Binding: Associates `members`, or principals, with a `role`. +type Binding struct { + // Condition: 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). + Condition *Expr `json:"condition,omitempty"` + + // Members: 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`. + Members []string `json:"members,omitempty"` + + // Role: Role that is assigned to the list of `members`, or principals. + // For example, `roles/viewer`, `roles/editor`, or `roles/owner`. + Role string `json:"role,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Condition") 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. "Condition") 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 *Binding) MarshalJSON() ([]byte, error) { + type NoMethod Binding + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ClusterMetadata: Information about the GKE cluster from which this +// Backup was created. +type ClusterMetadata struct { + // AnthosVersion: Anthos version + AnthosVersion string `json:"anthosVersion,omitempty"` + + // BackupCrdVersions: A list of the Backup for GKE CRD versions found in + // 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 string `json:"cluster,omitempty"` + + // GkeVersion: GKE version + GkeVersion string `json:"gkeVersion,omitempty"` + + // K8sVersion: The Kubernetes server version of the source cluster. + K8sVersion string `json:"k8sVersion,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AnthosVersion") 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. "AnthosVersion") 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 *ClusterMetadata) MarshalJSON() ([]byte, error) { + type NoMethod ClusterMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ClusterResourceRestoreScope: Identifies the cluster-scoped resources +// to restore from the Backup. +type ClusterResourceRestoreScope struct { + // SelectedGroupKinds: A list of "types" of cluster-scoped resources to + // be restored from the Backup. An empty list means that NO + // cluster-scoped resources will be restored. Note that Namespaces and + // PersistentVolume restoration is handled separately and is not + // governed by this field. + SelectedGroupKinds []*GroupKind `json:"selectedGroupKinds,omitempty"` + + // ForceSendFields is a list of field names (e.g. "SelectedGroupKinds") + // 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. "SelectedGroupKinds") 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 *ClusterResourceRestoreScope) MarshalJSON() ([]byte, error) { + type NoMethod ClusterResourceRestoreScope + 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 +// instance: service Foo { rpc Bar(google.protobuf.Empty) returns +// (google.protobuf.Empty); } +type Empty struct { + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` +} + +// EncryptionKey: Defined a customer managed encryption key that will be +// used to encrypt Backup artifacts. +type EncryptionKey struct { + // GcpKmsEncryptionKey: Google Cloud KMS encryption key. Format: + // projects//locations//keyRings//cryptoKeys/ + GcpKmsEncryptionKey string `json:"gcpKmsEncryptionKey,omitempty"` + + // ForceSendFields is a list of field names (e.g. "GcpKmsEncryptionKey") + // 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. "GcpKmsEncryptionKey") 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 *EncryptionKey) MarshalJSON() ([]byte, error) { + type NoMethod EncryptionKey + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// Expr: Represents a textual expression in the Common Expression +// Language (CEL) syntax. CEL is a C-like expression language. The +// syntax and semantics of CEL are documented at +// https://github.com/google/cel-spec. Example (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 Expr 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 *Expr) MarshalJSON() ([]byte, error) { + type NoMethod Expr + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GoogleLongrunningCancelOperationRequest: The request message for +// Operations.CancelOperation. +type GoogleLongrunningCancelOperationRequest struct { +} + +// GoogleLongrunningListOperationsResponse: The response message for +// Operations.ListOperations. +type GoogleLongrunningListOperationsResponse struct { + // NextPageToken: The standard List next-page token. + NextPageToken string `json:"nextPageToken,omitempty"` + + // Operations: A list of operations that matches the specified filter in + // the request. + Operations []*GoogleLongrunningOperation `json:"operations,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 *GoogleLongrunningListOperationsResponse) MarshalJSON() ([]byte, error) { + type NoMethod GoogleLongrunningListOperationsResponse + 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) +} + +// GroupKind: This is a direct map to the Kubernetes GroupKind type +// GroupKind +// (https://godoc.org/k8s.io/apimachinery/pkg/runtime/schema#GroupKind) +// and is used for identifying specific "types" of resources to restore. +type GroupKind struct { + // ResourceGroup: API group string of a Kubernetes resource, e.g. + // "apiextensions.k8s.io", "storage.k8s.io", etc. Note: use empty string + // for core API group + ResourceGroup string `json:"resourceGroup,omitempty"` + + // ResourceKind: Kind of a Kubernetes resource, e.g. + // "CustomResourceDefinition", "StorageClass", etc. + ResourceKind string `json:"resourceKind,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ResourceGroup") 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. "ResourceGroup") 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 *GroupKind) MarshalJSON() ([]byte, error) { + type NoMethod GroupKind + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ListBackupPlansResponse: Response message for ListBackupPlans. +type ListBackupPlansResponse struct { + // BackupPlans: The list of BackupPlans. + BackupPlans []*BackupPlan `json:"backupPlans,omitempty"` + + // 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. + NextPageToken string `json:"nextPageToken,omitempty"` + + // Unreachable: Locations that could not be reached. + Unreachable []string `json:"unreachable,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "BackupPlans") 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. "BackupPlans") 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 *ListBackupPlansResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListBackupPlansResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ListBackupsResponse: Response message for ListBackups. +type ListBackupsResponse struct { + // Backups: The list of restore resources within the parent. + Backups []*Backup `json:"backups,omitempty"` + + // 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. + 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. "Backups") 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. "Backups") 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 *ListBackupsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListBackupsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ListLocationsResponse: The response message for +// Locations.ListLocations. +type ListLocationsResponse struct { + // Locations: A list of locations that matches the specified filter in + // the request. + Locations []*Location `json:"locations,omitempty"` + + // NextPageToken: The standard List next-page token. + 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. "Locations") 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. "Locations") 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 *ListLocationsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListLocationsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ListRestorePlansResponse: Response message for ListRestorePlans. +type ListRestorePlansResponse struct { + // 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 []*RestorePlan `json:"restorePlans,omitempty"` + + // Unreachable: Locations that could not be reached. + Unreachable []string `json:"unreachable,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 *ListRestorePlansResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListRestorePlansResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ListRestoresResponse: Response message for ListRestores. +type ListRestoresResponse struct { + // 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 []*Restore `json:"restores,omitempty"` + + // Unreachable: Locations that could not be reached. + Unreachable []string `json:"unreachable,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 *ListRestoresResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListRestoresResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ListVolumeBackupsResponse: Response message for ListVolumeBackups. +type ListVolumeBackupsResponse struct { + // 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 []*VolumeBackup `json:"volumeBackups,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 *ListVolumeBackupsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListVolumeBackupsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ListVolumeRestoresResponse: Response message for ListVolumeRestores. +type ListVolumeRestoresResponse struct { + // 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 []*VolumeRestore `json:"volumeRestores,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 *ListVolumeRestoresResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListVolumeRestoresResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// Location: A resource that represents Google Cloud Platform location. +type Location struct { + // DisplayName: The friendly name for this location, typically a nearby + // city name. For example, "Tokyo". + DisplayName string `json:"displayName,omitempty"` + + // Labels: Cross-service attributes for the location. For example + // {"cloud.googleapis.com/region": "us-east1"} + Labels map[string]string `json:"labels,omitempty"` + + // LocationId: The canonical id for this location. For example: + // "us-east1". + LocationId string `json:"locationId,omitempty"` + + // Metadata: Service-specific metadata. For example the available + // capacity at the given location. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` + + // Name: Resource name for the location, which may vary between + // implementations. For example: + // "projects/example-project/locations/us-east1" + Name string `json:"name,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "DisplayName") 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. "DisplayName") 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 *Location) MarshalJSON() ([]byte, error) { + type NoMethod Location + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// NamespacedName: A reference to a namespaced resource in Kubernetes. +type NamespacedName struct { + // Name: The name of the Kubernetes resource. + Name string `json:"name,omitempty"` + + // Namespace: The Namespace of the Kubernetes resource. + Namespace string `json:"namespace,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Name") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. 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. "Name") 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 *NamespacedName) MarshalJSON() ([]byte, error) { + type NoMethod NamespacedName + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// NamespacedNames: A list of namespaced Kubernetes resources. +type NamespacedNames struct { + // NamespacedNames: A list of namespaced Kubernetes resources. + NamespacedNames []*NamespacedName `json:"namespacedNames,omitempty"` + + // ForceSendFields is a list of field names (e.g. "NamespacedNames") 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. "NamespacedNames") 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 *NamespacedNames) MarshalJSON() ([]byte, error) { + type NoMethod NamespacedNames + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// Namespaces: A list of Kubernetes Namespaces +type Namespaces struct { + // Namespaces: A list of Kubernetes Namespaces + Namespaces []string `json:"namespaces,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Namespaces") 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. "Namespaces") 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 *Namespaces) MarshalJSON() ([]byte, error) { + type NoMethod Namespaces + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// OperationMetadata: Represents the metadata of the long-running +// operation. +type OperationMetadata struct { + // ApiVersion: Output only. API version used to start the operation. + ApiVersion string `json:"apiVersion,omitempty"` + + // CreateTime: Output only. The time the operation was created. + CreateTime string `json:"createTime,omitempty"` + + // EndTime: Output only. The time the operation finished running. + EndTime string `json:"endTime,omitempty"` + + // RequestedCancellation: Output only. Identifies whether the user has + // requested cancellation of the operation. Operations that have + // successfully been cancelled have Operation.error value with a + // google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`. + RequestedCancellation bool `json:"requestedCancellation,omitempty"` + + // StatusMessage: Output only. Human-readable status of the operation, + // if any. + StatusMessage string `json:"statusMessage,omitempty"` + + // Target: Output only. Server-defined resource path for the target of + // the operation. + Target string `json:"target,omitempty"` + + // Verb: Output only. Name of the verb executed by the operation. + Verb string `json:"verb,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ApiVersion") 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. "ApiVersion") 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 *OperationMetadata) MarshalJSON() ([]byte, error) { + type NoMethod OperationMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// Policy: An Identity and Access Management (IAM) policy, which +// specifies access controls for Google Cloud resources. A `Policy` is a +// collection of `bindings`. A `binding` binds one or more `members`, or +// principals, to a single `role`. Principals can be user accounts, +// service accounts, Google groups, and domains (such as G Suite). A +// `role` is a named list of permissions; each `role` can be an IAM +// predefined role or a user-created custom role. For some types of +// Google Cloud resources, a `binding` can also specify a `condition`, +// which is a logical expression that allows access to a resource only +// if the expression evaluates to `true`. A condition can add +// constraints based on attributes of the request, the resource, or +// both. To learn which resources support conditions in their IAM +// policies, see the IAM documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** { "bindings": [ { "role": +// "roles/resourcemanager.organizationAdmin", "members": [ +// "user:mike@example.com", "group:admins@example.com", +// "domain:google.com", +// "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { +// "role": "roles/resourcemanager.organizationViewer", "members": [ +// "user:eve@example.com" ], "condition": { "title": "expirable access", +// "description": "Does not grant access after Sep 2020", "expression": +// "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], +// "etag": "BwWWja0YfJA=", "version": 3 } **YAML example:** bindings: - +// members: - user:mike@example.com - group:admins@example.com - +// domain:google.com - +// serviceAccount:my-project-id@appspot.gserviceaccount.com role: +// roles/resourcemanager.organizationAdmin - members: - +// user:eve@example.com role: roles/resourcemanager.organizationViewer +// condition: title: expirable access description: Does not grant access +// after Sep 2020 expression: request.time < +// timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 +// For a description of IAM and its features, see the IAM documentation +// (https://cloud.google.com/iam/docs/). +type Policy struct { + // AuditConfigs: Specifies cloud audit logging configuration for this + // policy. + AuditConfigs []*AuditConfig `json:"auditConfigs,omitempty"` + + // Bindings: Associates a list of `members`, or principals, with a + // `role`. Optionally, may specify a `condition` that determines how and + // when the `bindings` are applied. Each of the `bindings` must contain + // at least one principal. The `bindings` in a `Policy` can refer to up + // to 1,500 principals; up to 250 of these principals can be Google + // groups. Each occurrence of a principal counts towards these limits. + // For example, if the `bindings` grant 50 different roles to + // `user:alice@example.com`, and not to any other principal, then you + // can add another 1,450 principals to the `bindings` in the `Policy`. + Bindings []*Binding `json:"bindings,omitempty"` + + // Etag: `etag` is used for optimistic concurrency control as a way to + // help prevent simultaneous updates of a policy from overwriting each + // other. It is strongly suggested that systems make use of the `etag` + // in the read-modify-write cycle to perform policy updates in order to + // avoid race conditions: An `etag` is returned in the response to + // `getIamPolicy`, and systems are expected to put that etag in the + // request to `setIamPolicy` to ensure that their change will be applied + // to the same version of the policy. **Important:** If you use IAM + // Conditions, you must include the `etag` field whenever you call + // `setIamPolicy`. If you omit this field, then IAM allows you to + // overwrite a version `3` policy with a version `1` policy, and all of + // the conditions in the version `3` policy are lost. + Etag string `json:"etag,omitempty"` + + // Version: Specifies the format of the policy. Valid values are `0`, + // `1`, and `3`. Requests that specify an invalid value are rejected. + // Any operation that affects conditional role bindings must specify + // version `3`. This requirement applies to the following operations: * + // Getting a policy that includes a conditional role binding * Adding a + // conditional role binding to a policy * Changing a conditional role + // binding in a policy * Removing any role binding, with or without a + // condition, from a policy that includes conditions **Important:** If + // you use IAM Conditions, you must include the `etag` field whenever + // you call `setIamPolicy`. If you omit this field, then IAM allows you + // to overwrite a version `3` policy with a version `1` policy, and all + // of the conditions in the version `3` policy are lost. If a policy + // does not include any conditions, operations on that policy may + // specify any valid version or leave the field unset. To learn which + // resources support conditions in their IAM policies, see the IAM + // documentation + // (https://cloud.google.com/iam/help/conditions/resource-policies). + Version int64 `json:"version,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "AuditConfigs") 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. "AuditConfigs") 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 *Policy) MarshalJSON() ([]byte, error) { + type NoMethod Policy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// Restore: Represents both a request to Restore some portion of a +// 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: + // 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. + Cluster string `json:"cluster,omitempty"` + + // CompleteTime: Output only. When the restore operation either + // successfully completed or failed. + 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 string `json:"createTime,omitempty"` + + // Description: User specified descriptive string for this Restore. + Description string `json:"description,omitempty"` + + // Etag: 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. + Etag string `json:"etag,omitempty"` + + // Labels: GCP Labels. + 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 int64 `json:"resourcesExcludedCount,omitempty"` + + // ResourcesFailedCount: Output only. Number of resources failed to be + // restored in this restore action. + ResourcesFailedCount int64 `json:"resourcesFailedCount,omitempty"` + + // ResourcesRestoredCount: Output only. Number of resources restored in + // this restore action. + ResourcesRestoredCount int64 `json:"resourcesRestoredCount,omitempty"` + + // RestoreConfig: Output only. Configuration of the Restore. Inherited + // from parent RestorePlan's restore_config. + RestoreConfig *RestoreConfig `json:"restoreConfig,omitempty"` + + // State: Output only. The current state of the Restore. + // + // Possible values: + // "STATE_UNSPECIFIED" - The Restore resource is in the process of + // being created. + // "CREATING" - The Restore resource has been created and the + // associated RestoreJob Kubernetes resource has been injected into + // target cluster. + // "IN_PROGRESS" - The gkebackup agent in the cluster has begun + // executing the restore operation. + // "SUCCEEDED" - The restore operation has completed successfully. + // Restored workloads may not yet be operational. + // "FAILED" - The restore operation has failed. + // "DELETING" - This Restore resource is in the process of being + // deleted. + State string `json:"state,omitempty"` + + // StateReason: Output only. Human-readable description of why the + // Restore is in its current state. + StateReason string `json:"stateReason,omitempty"` + + // Uid: Output only. [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 string `json:"updateTime,omitempty"` + + // VolumesRestoredCount: Output only. Number of volumes restored in this + // restore action. + VolumesRestoredCount int64 `json:"volumesRestoredCount,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Backup") 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. "Backup") 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 *Restore) MarshalJSON() ([]byte, error) { + type NoMethod Restore + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// RestoreConfig: Configuration of a restore. Next id: 9 +type RestoreConfig struct { + // AllNamespaces: Restore all namespaced resources in the Backup if set + // to "True". Specifying this field to "False" is an error. + AllNamespaces bool `json:"allNamespaces,omitempty"` + + // ClusterResourceConflictPolicy: Defines the behavior for handling the + // situation where cluster-scoped resources being restored already exist + // in the target cluster. This MUST be set to a value other than + // CLUSTER_RESOURCE_CONFLICT_POLICY_UNSPECIFIED if + // cluster_resource_restore_scope is not empty. + // + // Possible values: + // "CLUSTER_RESOURCE_CONFLICT_POLICY_UNSPECIFIED" - Unspecified. Only + // allowed if no cluster-scoped resources will be restored. + // "USE_EXISTING_VERSION" - Do not attempt to restore the conflicting + // resource. + // "USE_BACKUP_VERSION" - Delete the existing version before + // re-creating it from the Backup. Note that this is a dangerous option + // which could cause unintentional data loss if used inappropriately - + // for example, deleting a CRD will cause Kubernetes to delete all CRs + // of that type. + ClusterResourceConflictPolicy string `json:"clusterResourceConflictPolicy,omitempty"` + + // ClusterResourceRestoreScope: Identifies the cluster-scoped resources + // to restore from the Backup. Not specifying it means NO cluster + // resource will be restored. + ClusterResourceRestoreScope *ClusterResourceRestoreScope `json:"clusterResourceRestoreScope,omitempty"` + + // 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 . + // + // Possible values: + // "NAMESPACED_RESOURCE_RESTORE_MODE_UNSPECIFIED" - Unspecified. Only + // allowed if no namespaced resources will be restored. + // "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 + // 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. + // "FAIL_ON_CONFLICT" - 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. + NamespacedResourceRestoreMode string `json:"namespacedResourceRestoreMode,omitempty"` + + // SelectedApplications: A list of selected ProtectedApplications to + // restore. The listed ProtectedApplications and all the resources to + // which they refer will be restored. + SelectedApplications *NamespacedNames `json:"selectedApplications,omitempty"` + + // SelectedNamespaces: A list of selected Namespaces to restore from the + // Backup. The listed Namespaces and all resources contained in them + // will be restored. + SelectedNamespaces *Namespaces `json:"selectedNamespaces,omitempty"` + + // SubstitutionRules: A list of transformation rules to be applied + // against Kubernetes resources as they are selected for restoration + // from a Backup. Rules are executed in order defined - this order + // matters, as changes made by a rule may impact the filtering logic of + // subsequent rules. An empty list means no substitution will occur. + SubstitutionRules []*SubstitutionRule `json:"substitutionRules,omitempty"` + + // VolumeDataRestorePolicy: Specifies the mechanism to be used to + // restore volume data. Default: VOLUME_DATA_RESTORE_POLICY_UNSPECIFIED + // (will be treated as NO_VOLUME_DATA_RESTORATION). + // + // Possible values: + // "VOLUME_DATA_RESTORE_POLICY_UNSPECIFIED" - unspecified, default + // value + // "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. + // "REUSE_VOLUME_HANDLE_FROM_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. + // "NO_VOLUME_DATA_RESTORATION" - 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. + VolumeDataRestorePolicy string `json:"volumeDataRestorePolicy,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AllNamespaces") 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. "AllNamespaces") 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 *RestoreConfig) MarshalJSON() ([]byte, error) { + type NoMethod RestoreConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// RestorePlan: The configuration of a potential series of Restore +// 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 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/* + 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 string `json:"createTime,omitempty"` + + // Description: User specified descriptive string for this RestorePlan. + Description string `json:"description,omitempty"` + + // Etag: 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. + 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 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 + // (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 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. "BackupPlan") 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. "BackupPlan") 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 *RestorePlan) MarshalJSON() ([]byte, error) { + type NoMethod RestorePlan + raw := NoMethod(*s) + 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 +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) + 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 + // 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) + BackupRetainDays int64 `json:"backupRetainDays,omitempty"` + + // Locked: This flag denotes whether the retention policy of this + // BackupPlan is locked. If set to True, no further update is allowed on + // this policy, including the `locked` field itself. Default: False + Locked bool `json:"locked,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "BackupDeleteLockDays") 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. "BackupDeleteLockDays") 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 *RetentionPolicy) MarshalJSON() ([]byte, error) { + type NoMethod RetentionPolicy + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// 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 string `json:"cronSchedule,omitempty"` + + // Paused: This flag denotes whether automatic Backup creation is paused + // for this BackupPlan. Default: False + Paused bool `json:"paused,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CronSchedule") 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. "CronSchedule") 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 *Schedule) MarshalJSON() ([]byte, error) { + type NoMethod Schedule + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// SetIamPolicyRequest: Request message for `SetIamPolicy` method. +type SetIamPolicyRequest struct { + // Policy: REQUIRED: The complete policy to be applied to the + // `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. + Policy *Policy `json:"policy,omitempty"` + + // UpdateMask: 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" + UpdateMask string `json:"updateMask,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Policy") 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. "Policy") 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 *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { + type NoMethod SetIamPolicyRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// SubstitutionRule: A transformation rule to be applied against +// Kubernetes resources as they are selected for restoration from a +// Backup. A rule contains both filtering logic (which resources are +// subject to substitution) and substitution logic. +type SubstitutionRule struct { + // NewValue: This is the new value to set for any fields that pass the + // filtering and selection criteria. To remove a value from a Kubernetes + // resource, either leave this field unspecified, or set it to the empty + // string (""). + NewValue string `json:"newValue,omitempty"` + + // OriginalValuePattern: (Filtering parameter) This is a [regular + // expression] (https://en.wikipedia.org/wiki/Regular_expression) that + // is compared against the fields matched by the target_json_path + // expression (and must also have passed the previous filters). + // Substitution will not be performed against fields whose value does + // not match this expression. If this field is NOT specified, then ALL + // fields matched by the target_json_path expression will undergo + // substitution. Note that an empty (e.g., "", rather than unspecified) + // value for for this field will only match empty fields. + OriginalValuePattern string `json:"originalValuePattern,omitempty"` + + // TargetGroupKinds: (Filtering parameter) Any resource subject to + // substitution must belong to one of the listed "types". If this field + // is not provided, no type filtering will be performed (all resources + // of all types matching previous filtering parameters will be + // candidates for substitution). + TargetGroupKinds []*GroupKind `json:"targetGroupKinds,omitempty"` + + // TargetJsonPath: Required. This is a [JSONPath] + // (https://kubernetes.io/docs/reference/kubectl/jsonpath/) expression + // that matches specific fields of candidate resources and it operates + // as both a filtering parameter (resources that are not matched with + // this expression will not be candidates for substitution) as well as a + // field identifier (identifies exactly which fields out of the + // candidate resources will be modified). + TargetJsonPath string `json:"targetJsonPath,omitempty"` + + // TargetNamespaces: (Filtering parameter) Any resource subject to + // substitution must be contained within one of the listed Kubernetes + // Namespace in the Backup. If this field is not provided, no namespace + // filtering will be performed (all resources in all Namespaces, + // including all cluster-scoped resources, will be candidates for + // substitution). To mix cluster-scoped and namespaced resources in the + // same rule, use an empty string ("") as one of the target namespaces. + TargetNamespaces []string `json:"targetNamespaces,omitempty"` + + // ForceSendFields is a list of field names (e.g. "NewValue") 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. "NewValue") 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 *SubstitutionRule) MarshalJSON() ([]byte, error) { + type NoMethod SubstitutionRule + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// TestIamPermissionsRequest: Request message for `TestIamPermissions` +// method. +type TestIamPermissionsRequest struct { + // Permissions: 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). + Permissions []string `json:"permissions,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Permissions") 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. "Permissions") 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 *TestIamPermissionsRequest) MarshalJSON() ([]byte, error) { + type NoMethod TestIamPermissionsRequest + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// TestIamPermissionsResponse: Response message for `TestIamPermissions` +// method. +type TestIamPermissionsResponse struct { + // Permissions: A subset of `TestPermissionsRequest.permissions` that + // the caller is allowed. + Permissions []string `json:"permissions,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Permissions") 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. "Permissions") 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 *TestIamPermissionsResponse) MarshalJSON() ([]byte, error) { + type NoMethod TestIamPermissionsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// VolumeBackup: Represents the backup of a specific persistent volume +// 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 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 string `json:"createTime,omitempty"` + + // DiskSizeBytes: Output only. The minimum size of the disk to which + // this VolumeBackup can be restored. + DiskSizeBytes int64 `json:"diskSizeBytes,omitempty,string"` + + // Etag: 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. + Etag string `json:"etag,omitempty"` + + // Format: Output only. The format used for the volume backup. + // + // Possible values: + // "VOLUME_BACKUP_FORMAT_UNSPECIFIED" - Default value, not specified. + // "GCE_PERSISTENT_DISK" - Compute Engine Persistent Disk snapshot + // 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 string `json:"name,omitempty"` + + // SourcePvc: Output only. A reference to the source Kubernetes PVC from + // which this VolumeBackup was created. + SourcePvc *NamespacedName `json:"sourcePvc,omitempty"` + + // State: Output only. The current state of this VolumeBackup. + // + // Possible values: + // "STATE_UNSPECIFIED" - This is an illegal state and should not be + // encountered. + // "CREATING" - A volume for the backup was identified and backup + // process is about to start. + // "SNAPSHOTTING" - The volume backup operation has begun and is in + // the initial "snapshot" phase of the process. Any defined + // ProtectedApplication "pre" hooks will be executed before entering + // this state and "post" hooks will be executed upon leaving this state. + // "UPLOADING" - The snapshot phase of the volume backup operation has + // completed and the snapshot is now being uploaded to backup storage. + // "SUCCEEDED" - The volume backup operation has completed + // successfully. + // "FAILED" - The volume backup operation has failed. + // "DELETING" - This VolumeBackup resource (and its associated + // artifacts) is in the process of being deleted. + State string `json:"state,omitempty"` + + // StateMessage: Output only. A human readable message explaining why + // the VolumeBackup is in its current state. + StateMessage string `json:"stateMessage,omitempty"` + + // StorageBytes: Output only. The aggregate size of the underlying + // artifacts associated with this VolumeBackup in the backup storage. + // This may change over time when multiple backups of the same volume + // share the same backup storage location. In particular, this is likely + // to increase in size when the immediately preceding backup of the same + // volume is deleted. + StorageBytes int64 `json:"storageBytes,omitempty,string"` + + // Uid: Output only. [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 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. + VolumeBackupHandle string `json:"volumeBackupHandle,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "CompleteTime") 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. "CompleteTime") 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 *VolumeBackup) MarshalJSON() ([]byte, error) { + type NoMethod VolumeBackup + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// 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 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 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. + 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-'. + Name string `json:"name,omitempty"` + + // State: Output only. The current state of this VolumeRestore + // + // Possible values: + // "STATE_UNSPECIFIED" - This is an illegal state and should not be + // encountered. + // "CREATING" - A volume for the restore was identified and restore + // process is about to start. + // "RESTORING" - The volume is currently being restored. + // "SUCCEEDED" - The volume has been successfully restored. + // "FAILED" - The volume restoration process failed. + // "DELETING" - This VolumeRestore resource is in the process of being + // deleted. + State string `json:"state,omitempty"` + + // StateMessage: Output only. A human readable message explaining why + // the VolumeRestore is in its current state. + StateMessage string `json:"stateMessage,omitempty"` + + // TargetPvc: Output only. The reference to the target Kubernetes PVC to + // be restored. + TargetPvc *NamespacedName `json:"targetPvc,omitempty"` + + // Uid: Output only. [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 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/* + 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. + VolumeHandle string `json:"volumeHandle,omitempty"` + + // VolumeType: Output only. The type of volume provisioned + // + // Possible values: + // "VOLUME_TYPE_UNSPECIFIED" - Default + // "GCE_PERSISTENT_DISK" - Compute Engine Persistent Disk volume + VolumeType string `json:"volumeType,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "CompleteTime") 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. "CompleteTime") 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 *VolumeRestore) MarshalJSON() ([]byte, error) { + type NoMethod VolumeRestore + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// method id "gkebackup.projects.locations.deleteOperations": + +type ProjectsLocationsDeleteOperationsCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// DeleteOperations: Deletes a long-running operation. This method +// indicates that the client is no longer interested in the operation +// result. It does not cancel the operation. If the server doesn't +// support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. +// +// - name: The name of the operation resource to be deleted. +func (r *ProjectsLocationsService) DeleteOperations(name string) *ProjectsLocationsDeleteOperationsCall { + c := &ProjectsLocationsDeleteOperationsCall{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 *ProjectsLocationsDeleteOperationsCall) Fields(s ...googleapi.Field) *ProjectsLocationsDeleteOperationsCall { + 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 *ProjectsLocationsDeleteOperationsCall) Context(ctx context.Context) *ProjectsLocationsDeleteOperationsCall { + 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 *ProjectsLocationsDeleteOperationsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsDeleteOperationsCall) 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, "v1/{+name}/operations") + 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 "gkebackup.projects.locations.deleteOperations" call. +// Exactly one of *Empty or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Empty.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 *ProjectsLocationsDeleteOperationsCall) Do(opts ...googleapi.CallOption) (*Empty, 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 := &Empty{ + 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 long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations", + // "httpMethod": "DELETE", + // "id": "gkebackup.projects.locations.deleteOperations", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource to be deleted.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}/operations", + // "response": { + // "$ref": "Empty" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.get": + +type ProjectsLocationsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Gets information about a location. +// +// - name: Resource name for the location. +func (r *ProjectsLocationsService) Get(name string) *ProjectsLocationsGetCall { + c := &ProjectsLocationsGetCall{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 *ProjectsLocationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsGetCall { + 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 *ProjectsLocationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsGetCall { + 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 *ProjectsLocationsGetCall) Context(ctx context.Context) *ProjectsLocationsGetCall { + 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 *ProjectsLocationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsGetCall) 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, "v1/{+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 "gkebackup.projects.locations.get" call. +// Exactly one of *Location or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Location.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 *ProjectsLocationsGetCall) Do(opts ...googleapi.CallOption) (*Location, 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 := &Location{ + 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 information about a location.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Resource name for the location.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Location" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.list": + +type ProjectsLocationsListCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists information about the supported locations for this +// service. +// +// - name: The resource that owns the locations collection, if +// applicable. +func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall { + c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// 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). +func (c *ProjectsLocationsListCall) Filter(filter string) *ProjectsLocationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number +// of results to return. If not set, the service selects a default. +func (c *ProjectsLocationsListCall) PageSize(pageSize int64) *ProjectsLocationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": A page token +// received from the `next_page_token` field in the response. Send that +// page token to receive the subsequent page. +func (c *ProjectsLocationsListCall) PageToken(pageToken string) *ProjectsLocationsListCall { + 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 *ProjectsLocationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsListCall { + 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 *ProjectsLocationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsListCall { + 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 *ProjectsLocationsListCall) Context(ctx context.Context) *ProjectsLocationsListCall { + 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 *ProjectsLocationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsListCall) 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, "v1/{+name}/locations") + 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 "gkebackup.projects.locations.list" call. +// Exactly one of *ListLocationsResponse or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *ListLocationsResponse.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 *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*ListLocationsResponse, 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 := &ListLocationsResponse{ + 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 information about the supported locations for this service.", + // "flatPath": "v1/projects/{projectsId}/locations", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.list", + // "parameterOrder": [ + // "name" + // ], + // "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).", + // "location": "query", + // "type": "string" + // }, + // "name": { + // "description": "The resource that owns the locations collection, if applicable.", + // "location": "path", + // "pattern": "^projects/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "pageSize": { + // "description": "The maximum number of results to return. If not set, the service selects a default.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}/locations", + // "response": { + // "$ref": "ListLocationsResponse" + // }, + // "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 *ProjectsLocationsListCall) Pages(ctx context.Context, f func(*ListLocationsResponse) 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 "gkebackup.projects.locations.backupPlans.create": + +type ProjectsLocationsBackupPlansCreateCall struct { + s *Service + parent string + backupplan *BackupPlan + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new BackupPlan in a given location. +// +// - parent: The location within which to create the BackupPlan. Format: +// projects/{project}/locations/{location}. +func (r *ProjectsLocationsBackupPlansService) Create(parent string, backupplan *BackupPlan) *ProjectsLocationsBackupPlansCreateCall { + c := &ProjectsLocationsBackupPlansCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.backupplan = backupplan + return c +} + +// 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 +// unique within the set of BackupPlans in this location +func (c *ProjectsLocationsBackupPlansCreateCall) BackupPlanId(backupPlanId string) *ProjectsLocationsBackupPlansCreateCall { + c.urlParams_.Set("backupPlanId", backupPlanId) + 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 *ProjectsLocationsBackupPlansCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansCreateCall { + 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 *ProjectsLocationsBackupPlansCreateCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansCreateCall { + 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 *ProjectsLocationsBackupPlansCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansCreateCall) 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.backupplan) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/backupPlans") + 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 "gkebackup.projects.locations.backupPlans.create" 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 *ProjectsLocationsBackupPlansCreateCall) 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 new BackupPlan in a given location.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans", + // "httpMethod": "POST", + // "id": "gkebackup.projects.locations.backupPlans.create", + // "parameterOrder": [ + // "parent" + // ], + // "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", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The location within which to create the BackupPlan. Format: projects/{project}/locations/{location}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/backupPlans", + // "request": { + // "$ref": "BackupPlan" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.backupPlans.delete": + +type ProjectsLocationsBackupPlansDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes an existing BackupPlan. +// +// - name: Fully qualified BackupPlan name. Format: +// projects/{project}/locations/{location}/backupPlans/{backup_plan}. +func (r *ProjectsLocationsBackupPlansService) Delete(name string) *ProjectsLocationsBackupPlansDeleteCall { + c := &ProjectsLocationsBackupPlansDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Etag sets the optional parameter "etag": If provided, this value must +// match the value currently assigned to the target resource. +func (c *ProjectsLocationsBackupPlansDeleteCall) Etag(etag string) *ProjectsLocationsBackupPlansDeleteCall { + 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 *ProjectsLocationsBackupPlansDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansDeleteCall { + 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 *ProjectsLocationsBackupPlansDeleteCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansDeleteCall { + 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 *ProjectsLocationsBackupPlansDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansDeleteCall) 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, "v1/{+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 "gkebackup.projects.locations.backupPlans.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 *ProjectsLocationsBackupPlansDeleteCall) 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 an existing BackupPlan.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}", + // "httpMethod": "DELETE", + // "id": "gkebackup.projects.locations.backupPlans.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "etag": { + // "description": "If provided, this value must match the value currently assigned to the target resource.", + // "location": "query", + // "type": "string" + // }, + // "name": { + // "description": "Required. Fully qualified BackupPlan name. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.backupPlans.get": + +type ProjectsLocationsBackupPlansGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Retrieve the details of a single BackupPlan. +// +// - name: Fully qualified BackupPlan name. Format: +// projects/{project}/locations/{location}/backupPlans/{backup_plan}. +func (r *ProjectsLocationsBackupPlansService) Get(name string) *ProjectsLocationsBackupPlansGetCall { + c := &ProjectsLocationsBackupPlansGetCall{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 *ProjectsLocationsBackupPlansGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansGetCall { + 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 *ProjectsLocationsBackupPlansGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsBackupPlansGetCall { + 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 *ProjectsLocationsBackupPlansGetCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansGetCall { + 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 *ProjectsLocationsBackupPlansGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansGetCall) 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, "v1/{+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 "gkebackup.projects.locations.backupPlans.get" call. +// Exactly one of *BackupPlan or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *BackupPlan.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 *ProjectsLocationsBackupPlansGetCall) Do(opts ...googleapi.CallOption) (*BackupPlan, 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 := &BackupPlan{ + 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": "Retrieve the details of a single BackupPlan.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.backupPlans.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. Fully qualified BackupPlan name. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "BackupPlan" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.backupPlans.getIamPolicy": + +type ProjectsLocationsBackupPlansGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. +// +// - resource: REQUIRED: The resource for which the policy is being +// requested. See the operation documentation for the appropriate +// value for this field. +func (r *ProjectsLocationsBackupPlansService) GetIamPolicy(resource string) *ProjectsLocationsBackupPlansGetIamPolicyCall { + c := &ProjectsLocationsBackupPlansGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + return c +} + +// OptionsRequestedPolicyVersion sets the optional parameter +// "options.requestedPolicyVersion": The maximum policy version that +// will be used to format the policy. Valid values are 0, 1, and 3. +// Requests specifying an invalid value will be rejected. Requests for +// policies with any conditional role bindings must specify version 3. +// Policies with no conditional role bindings may specify any valid +// value or leave the field unset. The policy in the response might use +// the policy version that you specified, or it might use a lower policy +// version. For example, if you specify version 3, but the policy has no +// conditional role bindings, the response uses version 1. To learn +// which resources support conditions in their IAM policies, see the IAM +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +func (c *ProjectsLocationsBackupPlansGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsBackupPlansGetIamPolicyCall { + c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBackupPlansGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansGetIamPolicyCall { + 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 *ProjectsLocationsBackupPlansGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsBackupPlansGetIamPolicyCall { + 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 *ProjectsLocationsBackupPlansGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansGetIamPolicyCall { + 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 *ProjectsLocationsBackupPlansGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansGetIamPolicyCall) 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, "v1/{+resource}:getIamPolicy") + 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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.backupPlans.getIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *ProjectsLocationsBackupPlansGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &Policy{ + 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 access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.backupPlans.getIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "options.requestedPolicyVersion": { + // "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:getIamPolicy", + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.backupPlans.list": + +type ProjectsLocationsBackupPlansListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists BackupPlans in a given location. +// +// - parent: The location that contains the BackupPlans to list. Format: +// projects/{project}/locations/{location}. +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. +func (c *ProjectsLocationsBackupPlansListCall) Filter(filter string) *ProjectsLocationsBackupPlansListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": Sort results. +func (c *ProjectsLocationsBackupPlansListCall) OrderBy(orderBy string) *ProjectsLocationsBackupPlansListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": The target number of +// results to return in a single response. If not specified, a default +// value will be chosen by the service. Note that the response may +// inclue a partial list and a caller should only rely on the response's +// next_page_token to determine if there are more instances left to be +// queried. +func (c *ProjectsLocationsBackupPlansListCall) PageSize(pageSize int64) *ProjectsLocationsBackupPlansListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The value of +// next_page_token received from a previous `ListBackupPlans` call. +// Provide this to retrieve the subsequent page in a multi-page list of +// results. When paginating, all other parameters provided to +// `ListBackupPlans` must match the call that provided the page token. +func (c *ProjectsLocationsBackupPlansListCall) PageToken(pageToken string) *ProjectsLocationsBackupPlansListCall { + 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 *ProjectsLocationsBackupPlansListCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansListCall { + 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 *ProjectsLocationsBackupPlansListCall) IfNoneMatch(entityTag string) *ProjectsLocationsBackupPlansListCall { + 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 *ProjectsLocationsBackupPlansListCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansListCall { + 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 *ProjectsLocationsBackupPlansListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansListCall) 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, "v1/{+parent}/backupPlans") + 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 "gkebackup.projects.locations.backupPlans.list" call. +// Exactly one of *ListBackupPlansResponse or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *ListBackupPlansResponse.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 *ProjectsLocationsBackupPlansListCall) Do(opts ...googleapi.CallOption) (*ListBackupPlansResponse, 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 := &ListBackupPlansResponse{ + 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 BackupPlans in a given location.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.backupPlans.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "filter": { + // "description": "List filter.", + // "location": "query", + // "type": "string" + // }, + // "orderBy": { + // "description": "Sort results.", + // "location": "query", + // "type": "string" + // }, + // "pageSize": { + // "description": "The target number of results to return in a single response. If not specified, a default value will be chosen by the service. Note that the response may inclue a partial list and a caller should only rely on the response's next_page_token to determine if there are more instances left to be queried.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The value of next_page_token received from a previous `ListBackupPlans` call. Provide this to retrieve the subsequent page in a multi-page list of results. When paginating, all other parameters provided to `ListBackupPlans` must match the call that provided the page token.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The location that contains the BackupPlans to list. Format: projects/{project}/locations/{location}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/backupPlans", + // "response": { + // "$ref": "ListBackupPlansResponse" + // }, + // "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 *ProjectsLocationsBackupPlansListCall) Pages(ctx context.Context, f func(*ListBackupPlansResponse) 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 "gkebackup.projects.locations.backupPlans.patch": + +type ProjectsLocationsBackupPlansPatchCall struct { + s *Service + name string + backupplan *BackupPlan + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Update a BackupPlan. +// +// - name: Output only. [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 + c.backupplan = backupplan + return c +} + +// UpdateMask sets the optional parameter "updateMask": This is used to +// specify the fields to be overwritten in the BackupPlan targeted for +// update. The values for each of these updated fields will be taken +// from the `backup_plan` provided with this request. Field names are +// relative to the root of the resource (e.g., `description`, +// `backup_config.include_volume_data`, etc.) If no `update_mask` is +// provided, all fields in `backup_plan` will be written to the target +// BackupPlan resource. Note that OUTPUT_ONLY and IMMUTABLE fields in +// `backup_plan` are ignored and are not used to update the target +// BackupPlan. +func (c *ProjectsLocationsBackupPlansPatchCall) UpdateMask(updateMask string) *ProjectsLocationsBackupPlansPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBackupPlansPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansPatchCall { + 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 *ProjectsLocationsBackupPlansPatchCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansPatchCall { + 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 *ProjectsLocationsBackupPlansPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansPatchCall) 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.backupplan) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.backupPlans.patch" 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 *ProjectsLocationsBackupPlansPatchCall) 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": "Update a BackupPlan.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}", + // "httpMethod": "PATCH", + // "id": "gkebackup.projects.locations.backupPlans.patch", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Output only. [Output Only] The full name of the BackupPlan resource. Format: projects/*/locations/*/backupPlans/*", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "This is used to specify the fields to be overwritten in the BackupPlan targeted for update. The values for each of these updated fields will be taken from the `backup_plan` provided with this request. Field names are relative to the root of the resource (e.g., `description`, `backup_config.include_volume_data`, etc.) If no `update_mask` is provided, all fields in `backup_plan` will be written to the target BackupPlan resource. Note that OUTPUT_ONLY and IMMUTABLE fields in `backup_plan` are ignored and are not used to update the target BackupPlan.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "request": { + // "$ref": "BackupPlan" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.backupPlans.setIamPolicy": + +type ProjectsLocationsBackupPlansSetIamPolicyCall struct { + s *Service + resource string + setiampolicyrequest *SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy. Can return `NOT_FOUND`, +// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. +// +// - resource: REQUIRED: The resource for which the policy is being +// specified. See the operation documentation for the appropriate +// value for this field. +func (r *ProjectsLocationsBackupPlansService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsBackupPlansSetIamPolicyCall { + c := &ProjectsLocationsBackupPlansSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.setiampolicyrequest = setiampolicyrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBackupPlansSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansSetIamPolicyCall { + 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 *ProjectsLocationsBackupPlansSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansSetIamPolicyCall { + 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 *ProjectsLocationsBackupPlansSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansSetIamPolicyCall) 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.setiampolicyrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:setIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.backupPlans.setIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *ProjectsLocationsBackupPlansSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &Policy{ + 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": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}:setIamPolicy", + // "httpMethod": "POST", + // "id": "gkebackup.projects.locations.backupPlans.setIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:setIamPolicy", + // "request": { + // "$ref": "SetIamPolicyRequest" + // }, + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.backupPlans.testIamPermissions": + +type ProjectsLocationsBackupPlansTestIamPermissionsCall struct { + s *Service + resource string + testiampermissionsrequest *TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a `NOT_FOUND` error. Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See the operation documentation for the +// appropriate value for this field. +func (r *ProjectsLocationsBackupPlansService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsBackupPlansTestIamPermissionsCall { + c := &ProjectsLocationsBackupPlansTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.testiampermissionsrequest = testiampermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBackupPlansTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansTestIamPermissionsCall { + 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 *ProjectsLocationsBackupPlansTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansTestIamPermissionsCall { + 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 *ProjectsLocationsBackupPlansTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansTestIamPermissionsCall) 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.testiampermissionsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:testIamPermissions") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.backupPlans.testIamPermissions" call. +// Exactly one of *TestIamPermissionsResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *TestIamPermissionsResponse.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *ProjectsLocationsBackupPlansTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &TestIamPermissionsResponse{ + 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": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "gkebackup.projects.locations.backupPlans.testIamPermissions", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "TestIamPermissionsRequest" + // }, + // "response": { + // "$ref": "TestIamPermissionsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.backupPlans.backups.create": + +type ProjectsLocationsBackupPlansBackupsCreateCall struct { + s *Service + parent string + backup *Backup + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// 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}. +func (r *ProjectsLocationsBackupPlansBackupsService) Create(parent string, backup *Backup) *ProjectsLocationsBackupPlansBackupsCreateCall { + c := &ProjectsLocationsBackupPlansBackupsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.backup = backup + return c +} + +// 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 +func (c *ProjectsLocationsBackupPlansBackupsCreateCall) BackupId(backupId string) *ProjectsLocationsBackupPlansBackupsCreateCall { + c.urlParams_.Set("backupId", backupId) + 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 *ProjectsLocationsBackupPlansBackupsCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansBackupsCreateCall { + 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 *ProjectsLocationsBackupPlansBackupsCreateCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansBackupsCreateCall { + 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 *ProjectsLocationsBackupPlansBackupsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansBackupsCreateCall) 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.backup) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/backups") + 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 "gkebackup.projects.locations.backupPlans.backups.create" 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 *ProjectsLocationsBackupPlansBackupsCreateCall) 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 Backup for the given BackupPlan.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups", + // "httpMethod": "POST", + // "id": "gkebackup.projects.locations.backupPlans.backups.create", + // "parameterOrder": [ + // "parent" + // ], + // "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", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The BackupPlan within which to create the Backup. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/backups", + // "request": { + // "$ref": "Backup" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.backupPlans.backups.delete": + +type ProjectsLocationsBackupPlansBackupsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes an existing Backup. +// +// - name: Name of the Backup resource. Format: +// projects/{project}/locations/{location}/backupPlans/{backup_plan}/ba +// ckups/{backup}. +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. +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. +func (c *ProjectsLocationsBackupPlansBackupsDeleteCall) Force(force bool) *ProjectsLocationsBackupPlansBackupsDeleteCall { + c.urlParams_.Set("force", fmt.Sprint(force)) + 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 *ProjectsLocationsBackupPlansBackupsDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansBackupsDeleteCall { + 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 *ProjectsLocationsBackupPlansBackupsDeleteCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansBackupsDeleteCall { + 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 *ProjectsLocationsBackupPlansBackupsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansBackupsDeleteCall) 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, "v1/{+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 "gkebackup.projects.locations.backupPlans.backups.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 *ProjectsLocationsBackupPlansBackupsDeleteCall) 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 an existing Backup.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}", + // "httpMethod": "DELETE", + // "id": "gkebackup.projects.locations.backupPlans.backups.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "etag": { + // "description": "etag, if provided, it must match the server's etag for the delete to happen.", + // "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.", + // "location": "query", + // "type": "boolean" + // }, + // "name": { + // "description": "Required. Name of the Backup resource. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}/backups/{backup}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.backupPlans.backups.get": + +type ProjectsLocationsBackupPlansBackupsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// 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}. +func (r *ProjectsLocationsBackupPlansBackupsService) Get(name string) *ProjectsLocationsBackupPlansBackupsGetCall { + c := &ProjectsLocationsBackupPlansBackupsGetCall{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 *ProjectsLocationsBackupPlansBackupsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansBackupsGetCall { + 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 *ProjectsLocationsBackupPlansBackupsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsBackupPlansBackupsGetCall { + 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 *ProjectsLocationsBackupPlansBackupsGetCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansBackupsGetCall { + 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 *ProjectsLocationsBackupPlansBackupsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansBackupsGetCall) 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, "v1/{+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 "gkebackup.projects.locations.backupPlans.backups.get" call. +// Exactly one of *Backup or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Backup.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 *ProjectsLocationsBackupPlansBackupsGetCall) Do(opts ...googleapi.CallOption) (*Backup, 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 := &Backup{ + 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": "Retrieve the details of a single Backup.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.backupPlans.backups.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. Full name of the Backup resource. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}/backups/{backup}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Backup" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.backupPlans.backups.getIamPolicy": + +type ProjectsLocationsBackupPlansBackupsGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. +// +// - resource: REQUIRED: The resource for which the policy is being +// requested. See the operation documentation for the appropriate +// value for this field. +func (r *ProjectsLocationsBackupPlansBackupsService) GetIamPolicy(resource string) *ProjectsLocationsBackupPlansBackupsGetIamPolicyCall { + c := &ProjectsLocationsBackupPlansBackupsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + return c +} + +// OptionsRequestedPolicyVersion sets the optional parameter +// "options.requestedPolicyVersion": The maximum policy version that +// will be used to format the policy. Valid values are 0, 1, and 3. +// Requests specifying an invalid value will be rejected. Requests for +// policies with any conditional role bindings must specify version 3. +// Policies with no conditional role bindings may specify any valid +// value or leave the field unset. The policy in the response might use +// the policy version that you specified, or it might use a lower policy +// version. For example, if you specify version 3, but the policy has no +// conditional role bindings, the response uses version 1. To learn +// which resources support conditions in their IAM policies, see the IAM +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +func (c *ProjectsLocationsBackupPlansBackupsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsBackupPlansBackupsGetIamPolicyCall { + c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBackupPlansBackupsGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansBackupsGetIamPolicyCall { + 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 *ProjectsLocationsBackupPlansBackupsGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsBackupPlansBackupsGetIamPolicyCall { + 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 *ProjectsLocationsBackupPlansBackupsGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansBackupsGetIamPolicyCall { + 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 *ProjectsLocationsBackupPlansBackupsGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansBackupsGetIamPolicyCall) 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, "v1/{+resource}:getIamPolicy") + 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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.backupPlans.backups.getIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *ProjectsLocationsBackupPlansBackupsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &Policy{ + 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 access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.backupPlans.backups.getIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "options.requestedPolicyVersion": { + // "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:getIamPolicy", + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.backupPlans.backups.list": + +type ProjectsLocationsBackupPlansBackupsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// 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}. +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. +func (c *ProjectsLocationsBackupPlansBackupsListCall) Filter(filter string) *ProjectsLocationsBackupPlansBackupsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": Sort results. +func (c *ProjectsLocationsBackupPlansBackupsListCall) OrderBy(orderBy string) *ProjectsLocationsBackupPlansBackupsListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": The target number of +// results to return in a single response. If not specified, a default +// value will be chosen by the service. Note that the response may +// inclue a partial list and a caller should only rely on the response's +// next_page_token to determine if there are more instances left to be +// queried. +func (c *ProjectsLocationsBackupPlansBackupsListCall) PageSize(pageSize int64) *ProjectsLocationsBackupPlansBackupsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The value of +// next_page_token received from a previous `ListBackups` call. Provide +// this to retrieve the subsequent page in a multi-page list of results. +// When paginating, all other parameters provided to `ListBackups` must +// match the call that provided the page token. +func (c *ProjectsLocationsBackupPlansBackupsListCall) PageToken(pageToken string) *ProjectsLocationsBackupPlansBackupsListCall { + 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 *ProjectsLocationsBackupPlansBackupsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansBackupsListCall { + 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 *ProjectsLocationsBackupPlansBackupsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsBackupPlansBackupsListCall { + 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 *ProjectsLocationsBackupPlansBackupsListCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansBackupsListCall { + 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 *ProjectsLocationsBackupPlansBackupsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansBackupsListCall) 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, "v1/{+parent}/backups") + 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 "gkebackup.projects.locations.backupPlans.backups.list" call. +// Exactly one of *ListBackupsResponse or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *ListBackupsResponse.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 *ProjectsLocationsBackupPlansBackupsListCall) Do(opts ...googleapi.CallOption) (*ListBackupsResponse, 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 := &ListBackupsResponse{ + 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 the Backups for a given BackupPlan.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.backupPlans.backups.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "filter": { + // "description": "List filter.", + // "location": "query", + // "type": "string" + // }, + // "orderBy": { + // "description": "Sort results.", + // "location": "query", + // "type": "string" + // }, + // "pageSize": { + // "description": "The target number of results to return in a single response. If not specified, a default value will be chosen by the service. Note that the response may inclue a partial list and a caller should only rely on the response's next_page_token to determine if there are more instances left to be queried.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The value of next_page_token received from a previous `ListBackups` call. Provide this to retrieve the subsequent page in a multi-page list of results. When paginating, all other parameters provided to `ListBackups` must match the call that provided the page token.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The BackupPlan that contains the Backups to list. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/backups", + // "response": { + // "$ref": "ListBackupsResponse" + // }, + // "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 *ProjectsLocationsBackupPlansBackupsListCall) Pages(ctx context.Context, f func(*ListBackupsResponse) 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 "gkebackup.projects.locations.backupPlans.backups.patch": + +type ProjectsLocationsBackupPlansBackupsPatchCall struct { + s *Service + name string + backup *Backup + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Update a Backup. +// +// - name: Output only. The fully qualified name of the Backup. +// projects/*/locations/*/backupPlans/*/backups/*. +func (r *ProjectsLocationsBackupPlansBackupsService) Patch(name string, backup *Backup) *ProjectsLocationsBackupPlansBackupsPatchCall { + c := &ProjectsLocationsBackupPlansBackupsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.backup = backup + return c +} + +// UpdateMask sets the optional parameter "updateMask": This is used to +// specify the fields to be overwritten in the Backup targeted for +// update. The values for each of these updated fields will be taken +// from the `backup_plan` provided with this request. Field names are +// relative to the root of the resource. If no `update_mask` is +// provided, all fields in `backup` will be written to the target Backup +// resource. Note that OUTPUT_ONLY and IMMUTABLE fields in `backup` are +// ignored and are not used to update the target Backup. +func (c *ProjectsLocationsBackupPlansBackupsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsBackupPlansBackupsPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBackupPlansBackupsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansBackupsPatchCall { + 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 *ProjectsLocationsBackupPlansBackupsPatchCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansBackupsPatchCall { + 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 *ProjectsLocationsBackupPlansBackupsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansBackupsPatchCall) 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.backup) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.backupPlans.backups.patch" 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 *ProjectsLocationsBackupPlansBackupsPatchCall) 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": "Update a Backup.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}", + // "httpMethod": "PATCH", + // "id": "gkebackup.projects.locations.backupPlans.backups.patch", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Output only. The fully qualified name of the Backup. projects/*/locations/*/backupPlans/*/backups/*", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "This is used to specify the fields to be overwritten in the Backup targeted for update. The values for each of these updated fields will be taken from the `backup_plan` provided with this request. Field names are relative to the root of the resource. If no `update_mask` is provided, all fields in `backup` will be written to the target Backup resource. Note that OUTPUT_ONLY and IMMUTABLE fields in `backup` are ignored and are not used to update the target Backup.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "request": { + // "$ref": "Backup" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.backupPlans.backups.setIamPolicy": + +type ProjectsLocationsBackupPlansBackupsSetIamPolicyCall struct { + s *Service + resource string + setiampolicyrequest *SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy. Can return `NOT_FOUND`, +// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. +// +// - resource: REQUIRED: The resource for which the policy is being +// specified. See the operation documentation for the appropriate +// value for this field. +func (r *ProjectsLocationsBackupPlansBackupsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsBackupPlansBackupsSetIamPolicyCall { + c := &ProjectsLocationsBackupPlansBackupsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.setiampolicyrequest = setiampolicyrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBackupPlansBackupsSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansBackupsSetIamPolicyCall { + 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 *ProjectsLocationsBackupPlansBackupsSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansBackupsSetIamPolicyCall { + 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 *ProjectsLocationsBackupPlansBackupsSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansBackupsSetIamPolicyCall) 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.setiampolicyrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:setIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.backupPlans.backups.setIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *ProjectsLocationsBackupPlansBackupsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &Policy{ + 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": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}:setIamPolicy", + // "httpMethod": "POST", + // "id": "gkebackup.projects.locations.backupPlans.backups.setIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:setIamPolicy", + // "request": { + // "$ref": "SetIamPolicyRequest" + // }, + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.backupPlans.backups.testIamPermissions": + +type ProjectsLocationsBackupPlansBackupsTestIamPermissionsCall struct { + s *Service + resource string + testiampermissionsrequest *TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a `NOT_FOUND` error. Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See the operation documentation for the +// appropriate value for this field. +func (r *ProjectsLocationsBackupPlansBackupsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsBackupPlansBackupsTestIamPermissionsCall { + c := &ProjectsLocationsBackupPlansBackupsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.testiampermissionsrequest = testiampermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBackupPlansBackupsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansBackupsTestIamPermissionsCall { + 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 *ProjectsLocationsBackupPlansBackupsTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansBackupsTestIamPermissionsCall { + 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 *ProjectsLocationsBackupPlansBackupsTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansBackupsTestIamPermissionsCall) 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.testiampermissionsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:testIamPermissions") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.backupPlans.backups.testIamPermissions" call. +// Exactly one of *TestIamPermissionsResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *TestIamPermissionsResponse.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *ProjectsLocationsBackupPlansBackupsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &TestIamPermissionsResponse{ + 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": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "gkebackup.projects.locations.backupPlans.backups.testIamPermissions", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "TestIamPermissionsRequest" + // }, + // "response": { + // "$ref": "TestIamPermissionsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.backupPlans.backups.volumeBackups.get": + +type ProjectsLocationsBackupPlansBackupsVolumeBackupsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// 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}. +func (r *ProjectsLocationsBackupPlansBackupsVolumeBackupsService) Get(name string) *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetCall { + c := &ProjectsLocationsBackupPlansBackupsVolumeBackupsGetCall{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 *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetCall { + 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 *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetCall { + 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 *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetCall { + 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 *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetCall) 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, "v1/{+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 "gkebackup.projects.locations.backupPlans.backups.volumeBackups.get" call. +// Exactly one of *VolumeBackup or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *VolumeBackup.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 *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetCall) Do(opts ...googleapi.CallOption) (*VolumeBackup, 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 := &VolumeBackup{ + 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": "Retrieve the details of a single VolumeBackup.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}/volumeBackups/{volumeBackupsId}", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.backupPlans.backups.volumeBackups.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. Full name of the VolumeBackup resource. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}/backups/{backup}/volumeBackups/{volume_backup}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+/volumeBackups/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "VolumeBackup" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.backupPlans.backups.volumeBackups.getIamPolicy": + +type ProjectsLocationsBackupPlansBackupsVolumeBackupsGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. +// +// - resource: REQUIRED: The resource for which the policy is being +// requested. See the operation documentation for the appropriate +// value for this field. +func (r *ProjectsLocationsBackupPlansBackupsVolumeBackupsService) GetIamPolicy(resource string) *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetIamPolicyCall { + c := &ProjectsLocationsBackupPlansBackupsVolumeBackupsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + return c +} + +// OptionsRequestedPolicyVersion sets the optional parameter +// "options.requestedPolicyVersion": The maximum policy version that +// will be used to format the policy. Valid values are 0, 1, and 3. +// Requests specifying an invalid value will be rejected. Requests for +// policies with any conditional role bindings must specify version 3. +// Policies with no conditional role bindings may specify any valid +// value or leave the field unset. The policy in the response might use +// the policy version that you specified, or it might use a lower policy +// version. For example, if you specify version 3, but the policy has no +// conditional role bindings, the response uses version 1. To learn +// which resources support conditions in their IAM policies, see the IAM +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +func (c *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetIamPolicyCall { + c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetIamPolicyCall { + 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 *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetIamPolicyCall { + 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 *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetIamPolicyCall { + 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 *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetIamPolicyCall) 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, "v1/{+resource}:getIamPolicy") + 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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.backupPlans.backups.volumeBackups.getIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *ProjectsLocationsBackupPlansBackupsVolumeBackupsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &Policy{ + 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 access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}/volumeBackups/{volumeBackupsId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.backupPlans.backups.volumeBackups.getIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "options.requestedPolicyVersion": { + // "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+/volumeBackups/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:getIamPolicy", + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.backupPlans.backups.volumeBackups.list": + +type ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// 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}. +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. +func (c *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall) Filter(filter string) *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": Sort results. +func (c *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall) OrderBy(orderBy string) *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": The target number of +// results to return in a single response. If not specified, a default +// value will be chosen by the service. Note that the response may +// inclue a partial list and a caller should only rely on the response's +// next_page_token to determine if there are more instances left to be +// queried. +func (c *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall) PageSize(pageSize int64) *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The value of +// next_page_token received from a previous `ListVolumeBackups` call. +// Provide this to retrieve the subsequent page in a multi-page list of +// results. When paginating, all other parameters provided to +// `ListVolumeBackups` must match the call that provided the page token. +func (c *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall) PageToken(pageToken string) *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall { + 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 *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall { + 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 *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall { + 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 *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall { + 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 *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall) 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, "v1/{+parent}/volumeBackups") + 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 "gkebackup.projects.locations.backupPlans.backups.volumeBackups.list" call. +// Exactly one of *ListVolumeBackupsResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *ListVolumeBackupsResponse.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 *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall) Do(opts ...googleapi.CallOption) (*ListVolumeBackupsResponse, 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 := &ListVolumeBackupsResponse{ + 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 the VolumeBackups for a given Backup.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}/volumeBackups", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.backupPlans.backups.volumeBackups.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "filter": { + // "description": "List filter.", + // "location": "query", + // "type": "string" + // }, + // "orderBy": { + // "description": "Sort results.", + // "location": "query", + // "type": "string" + // }, + // "pageSize": { + // "description": "The target number of results to return in a single response. If not specified, a default value will be chosen by the service. Note that the response may inclue a partial list and a caller should only rely on the response's next_page_token to determine if there are more instances left to be queried.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The value of next_page_token received from a previous `ListVolumeBackups` call. Provide this to retrieve the subsequent page in a multi-page list of results. When paginating, all other parameters provided to `ListVolumeBackups` must match the call that provided the page token.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The Backup that contains the VolumeBackups to list. Format: projects/{project}/locations/{location}/backupPlans/{backup_plan}/backups/{backup}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/volumeBackups", + // "response": { + // "$ref": "ListVolumeBackupsResponse" + // }, + // "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 *ProjectsLocationsBackupPlansBackupsVolumeBackupsListCall) Pages(ctx context.Context, f func(*ListVolumeBackupsResponse) 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 "gkebackup.projects.locations.backupPlans.backups.volumeBackups.setIamPolicy": + +type ProjectsLocationsBackupPlansBackupsVolumeBackupsSetIamPolicyCall struct { + s *Service + resource string + setiampolicyrequest *SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy. Can return `NOT_FOUND`, +// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. +// +// - resource: REQUIRED: The resource for which the policy is being +// specified. See the operation documentation for the appropriate +// value for this field. +func (r *ProjectsLocationsBackupPlansBackupsVolumeBackupsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsBackupPlansBackupsVolumeBackupsSetIamPolicyCall { + c := &ProjectsLocationsBackupPlansBackupsVolumeBackupsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.setiampolicyrequest = setiampolicyrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBackupPlansBackupsVolumeBackupsSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansBackupsVolumeBackupsSetIamPolicyCall { + 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 *ProjectsLocationsBackupPlansBackupsVolumeBackupsSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansBackupsVolumeBackupsSetIamPolicyCall { + 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 *ProjectsLocationsBackupPlansBackupsVolumeBackupsSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansBackupsVolumeBackupsSetIamPolicyCall) 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.setiampolicyrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:setIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.backupPlans.backups.volumeBackups.setIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *ProjectsLocationsBackupPlansBackupsVolumeBackupsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &Policy{ + 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": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}/volumeBackups/{volumeBackupsId}:setIamPolicy", + // "httpMethod": "POST", + // "id": "gkebackup.projects.locations.backupPlans.backups.volumeBackups.setIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+/volumeBackups/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:setIamPolicy", + // "request": { + // "$ref": "SetIamPolicyRequest" + // }, + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.backupPlans.backups.volumeBackups.testIamPermissions": + +type ProjectsLocationsBackupPlansBackupsVolumeBackupsTestIamPermissionsCall struct { + s *Service + resource string + testiampermissionsrequest *TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a `NOT_FOUND` error. Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See the operation documentation for the +// appropriate value for this field. +func (r *ProjectsLocationsBackupPlansBackupsVolumeBackupsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsBackupPlansBackupsVolumeBackupsTestIamPermissionsCall { + c := &ProjectsLocationsBackupPlansBackupsVolumeBackupsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.testiampermissionsrequest = testiampermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsBackupPlansBackupsVolumeBackupsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsBackupPlansBackupsVolumeBackupsTestIamPermissionsCall { + 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 *ProjectsLocationsBackupPlansBackupsVolumeBackupsTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsBackupPlansBackupsVolumeBackupsTestIamPermissionsCall { + 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 *ProjectsLocationsBackupPlansBackupsVolumeBackupsTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBackupPlansBackupsVolumeBackupsTestIamPermissionsCall) 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.testiampermissionsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:testIamPermissions") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.backupPlans.backups.volumeBackups.testIamPermissions" call. +// Exactly one of *TestIamPermissionsResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *TestIamPermissionsResponse.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *ProjectsLocationsBackupPlansBackupsVolumeBackupsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &TestIamPermissionsResponse{ + 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": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/backupPlans/{backupPlansId}/backups/{backupsId}/volumeBackups/{volumeBackupsId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "gkebackup.projects.locations.backupPlans.backups.volumeBackups.testIamPermissions", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+/backups/[^/]+/volumeBackups/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "TestIamPermissionsRequest" + // }, + // "response": { + // "$ref": "TestIamPermissionsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.operations.cancel": + +type ProjectsLocationsOperationsCancelCall struct { + s *Service + name string + googlelongrunningcanceloperationrequest *GoogleLongrunningCancelOperationRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Cancel: Starts asynchronous cancellation on a long-running operation. +// The server makes a best effort to cancel the operation, but success +// is not guaranteed. If the server doesn't support this method, it +// returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use +// Operations.GetOperation or other methods to check whether the +// cancellation succeeded or whether the operation completed despite +// cancellation. On successful cancellation, the operation is not +// deleted; instead, it becomes an operation with an Operation.error +// value with a google.rpc.Status.code of 1, corresponding to +// `Code.CANCELLED`. +// +// - name: The name of the operation resource to be cancelled. +func (r *ProjectsLocationsOperationsService) Cancel(name string, googlelongrunningcanceloperationrequest *GoogleLongrunningCancelOperationRequest) *ProjectsLocationsOperationsCancelCall { + c := &ProjectsLocationsOperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.googlelongrunningcanceloperationrequest = googlelongrunningcanceloperationrequest + 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 *ProjectsLocationsOperationsCancelCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsCancelCall { + 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 *ProjectsLocationsOperationsCancelCall) Context(ctx context.Context) *ProjectsLocationsOperationsCancelCall { + 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 *ProjectsLocationsOperationsCancelCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsOperationsCancelCall) 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.googlelongrunningcanceloperationrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}:cancel") + 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{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.operations.cancel" call. +// Exactly one of *Empty or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Empty.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 *ProjectsLocationsOperationsCancelCall) Do(opts ...googleapi.CallOption) (*Empty, 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 := &Empty{ + 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": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", + // "httpMethod": "POST", + // "id": "gkebackup.projects.locations.operations.cancel", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource to be cancelled.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}:cancel", + // "request": { + // "$ref": "GoogleLongrunningCancelOperationRequest" + // }, + // "response": { + // "$ref": "Empty" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.operations.get": + +type ProjectsLocationsOperationsGetCall 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 *ProjectsLocationsOperationsService) Get(name string) *ProjectsLocationsOperationsGetCall { + c := &ProjectsLocationsOperationsGetCall{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 *ProjectsLocationsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsGetCall { + 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 *ProjectsLocationsOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsOperationsGetCall { + 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 *ProjectsLocationsOperationsGetCall) Context(ctx context.Context) *ProjectsLocationsOperationsGetCall { + 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 *ProjectsLocationsOperationsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsOperationsGetCall) 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, "v1/{+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 "gkebackup.projects.locations.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 *ProjectsLocationsOperationsGetCall) 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": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.operations.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "The name of the operation resource.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.operations.list": + +type ProjectsLocationsOperationsListCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists operations that match the specified filter in the +// request. If the server doesn't support this method, it returns +// `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to +// override the binding to use different resource name schemes, such as +// `users/*/operations`. To override the binding, API services can add a +// binding such as "/v1/{name=users/*}/operations" to their service +// configuration. For backwards compatibility, the default name includes +// the operations collection id, however overriding users must ensure +// the name binding is the parent resource, without the operations +// collection id. +// +// - name: The name of the operation's parent resource. +func (r *ProjectsLocationsOperationsService) List(name string) *ProjectsLocationsOperationsListCall { + c := &ProjectsLocationsOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Filter sets the optional parameter "filter": The standard list +// filter. +func (c *ProjectsLocationsOperationsListCall) Filter(filter string) *ProjectsLocationsOperationsListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// PageSize sets the optional parameter "pageSize": The standard list +// page size. +func (c *ProjectsLocationsOperationsListCall) PageSize(pageSize int64) *ProjectsLocationsOperationsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The standard list +// page token. +func (c *ProjectsLocationsOperationsListCall) PageToken(pageToken string) *ProjectsLocationsOperationsListCall { + 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 *ProjectsLocationsOperationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsOperationsListCall { + 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 *ProjectsLocationsOperationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsOperationsListCall { + 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 *ProjectsLocationsOperationsListCall) Context(ctx context.Context) *ProjectsLocationsOperationsListCall { + 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 *ProjectsLocationsOperationsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsOperationsListCall) 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, "v1/{+name}/operations") + 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 "gkebackup.projects.locations.operations.list" call. +// Exactly one of *GoogleLongrunningListOperationsResponse or error will +// be non-nil. Any non-2xx status code is an error. Response headers are +// in either +// *GoogleLongrunningListOperationsResponse.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 *ProjectsLocationsOperationsListCall) Do(opts ...googleapi.CallOption) (*GoogleLongrunningListOperationsResponse, 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 := &GoogleLongrunningListOperationsResponse{ + 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 operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to override the binding to use different resource name schemes, such as `users/*/operations`. To override the binding, API services can add a binding such as `\"/v1/{name=users/*}/operations\"` to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.operations.list", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "filter": { + // "description": "The standard list filter.", + // "location": "query", + // "type": "string" + // }, + // "name": { + // "description": "The name of the operation's parent resource.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "pageSize": { + // "description": "The standard list page size.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The standard list page token.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}/operations", + // "response": { + // "$ref": "GoogleLongrunningListOperationsResponse" + // }, + // "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 *ProjectsLocationsOperationsListCall) Pages(ctx context.Context, f func(*GoogleLongrunningListOperationsResponse) 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 "gkebackup.projects.locations.restorePlans.create": + +type ProjectsLocationsRestorePlansCreateCall struct { + s *Service + parent string + restoreplan *RestorePlan + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a new RestorePlan in a given location. +// +// - parent: The location within which to create the RestorePlan. +// Format: projects/{project}/locations/{location}. +func (r *ProjectsLocationsRestorePlansService) Create(parent string, restoreplan *RestorePlan) *ProjectsLocationsRestorePlansCreateCall { + c := &ProjectsLocationsRestorePlansCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.restoreplan = restoreplan + return c +} + +// 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 +func (c *ProjectsLocationsRestorePlansCreateCall) RestorePlanId(restorePlanId string) *ProjectsLocationsRestorePlansCreateCall { + c.urlParams_.Set("restorePlanId", restorePlanId) + 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 *ProjectsLocationsRestorePlansCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsRestorePlansCreateCall { + 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 *ProjectsLocationsRestorePlansCreateCall) Context(ctx context.Context) *ProjectsLocationsRestorePlansCreateCall { + 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 *ProjectsLocationsRestorePlansCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRestorePlansCreateCall) 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.restoreplan) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/restorePlans") + 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 "gkebackup.projects.locations.restorePlans.create" 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 *ProjectsLocationsRestorePlansCreateCall) 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 new RestorePlan in a given location.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans", + // "httpMethod": "POST", + // "id": "gkebackup.projects.locations.restorePlans.create", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The location within which to create the RestorePlan. Format: projects/{project}/locations/{location}", + // "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", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/restorePlans", + // "request": { + // "$ref": "RestorePlan" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.restorePlans.delete": + +type ProjectsLocationsRestorePlansDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes an existing RestorePlan. +// +// - name: Fully qualified RestorePlan name. Format: +// projects/{project}/locations/{location}/restorePlans/{restore_plan}. +func (r *ProjectsLocationsRestorePlansService) Delete(name string) *ProjectsLocationsRestorePlansDeleteCall { + c := &ProjectsLocationsRestorePlansDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Etag sets the optional parameter "etag": If provided, this value must +// match the value currently assigned to the target resource. +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. +func (c *ProjectsLocationsRestorePlansDeleteCall) Force(force bool) *ProjectsLocationsRestorePlansDeleteCall { + c.urlParams_.Set("force", fmt.Sprint(force)) + 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 *ProjectsLocationsRestorePlansDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsRestorePlansDeleteCall { + 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 *ProjectsLocationsRestorePlansDeleteCall) Context(ctx context.Context) *ProjectsLocationsRestorePlansDeleteCall { + 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 *ProjectsLocationsRestorePlansDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRestorePlansDeleteCall) 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, "v1/{+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 "gkebackup.projects.locations.restorePlans.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 *ProjectsLocationsRestorePlansDeleteCall) 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 an existing RestorePlan.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}", + // "httpMethod": "DELETE", + // "id": "gkebackup.projects.locations.restorePlans.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "etag": { + // "description": "If provided, this value must match the value currently assigned to the target resource.", + // "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.", + // "location": "query", + // "type": "boolean" + // }, + // "name": { + // "description": "Required. Fully qualified RestorePlan name. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.restorePlans.get": + +type ProjectsLocationsRestorePlansGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Retrieve the details of a single RestorePlan. +// +// - name: Fully qualified RestorePlan name. Format: +// projects/{project}/locations/{location}/restorePlans/{restore_plan}. +func (r *ProjectsLocationsRestorePlansService) Get(name string) *ProjectsLocationsRestorePlansGetCall { + c := &ProjectsLocationsRestorePlansGetCall{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 *ProjectsLocationsRestorePlansGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsRestorePlansGetCall { + 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 *ProjectsLocationsRestorePlansGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsRestorePlansGetCall { + 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 *ProjectsLocationsRestorePlansGetCall) Context(ctx context.Context) *ProjectsLocationsRestorePlansGetCall { + 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 *ProjectsLocationsRestorePlansGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRestorePlansGetCall) 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, "v1/{+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 "gkebackup.projects.locations.restorePlans.get" call. +// Exactly one of *RestorePlan or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *RestorePlan.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 *ProjectsLocationsRestorePlansGetCall) Do(opts ...googleapi.CallOption) (*RestorePlan, 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 := &RestorePlan{ + 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": "Retrieve the details of a single RestorePlan.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.restorePlans.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. Fully qualified RestorePlan name. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "RestorePlan" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.restorePlans.getIamPolicy": + +type ProjectsLocationsRestorePlansGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. +// +// - resource: REQUIRED: The resource for which the policy is being +// requested. See the operation documentation for the appropriate +// value for this field. +func (r *ProjectsLocationsRestorePlansService) GetIamPolicy(resource string) *ProjectsLocationsRestorePlansGetIamPolicyCall { + c := &ProjectsLocationsRestorePlansGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + return c +} + +// OptionsRequestedPolicyVersion sets the optional parameter +// "options.requestedPolicyVersion": The maximum policy version that +// will be used to format the policy. Valid values are 0, 1, and 3. +// Requests specifying an invalid value will be rejected. Requests for +// policies with any conditional role bindings must specify version 3. +// Policies with no conditional role bindings may specify any valid +// value or leave the field unset. The policy in the response might use +// the policy version that you specified, or it might use a lower policy +// version. For example, if you specify version 3, but the policy has no +// conditional role bindings, the response uses version 1. To learn +// which resources support conditions in their IAM policies, see the IAM +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +func (c *ProjectsLocationsRestorePlansGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsRestorePlansGetIamPolicyCall { + c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsRestorePlansGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsRestorePlansGetIamPolicyCall { + 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 *ProjectsLocationsRestorePlansGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsRestorePlansGetIamPolicyCall { + 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 *ProjectsLocationsRestorePlansGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsRestorePlansGetIamPolicyCall { + 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 *ProjectsLocationsRestorePlansGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRestorePlansGetIamPolicyCall) 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, "v1/{+resource}:getIamPolicy") + 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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.restorePlans.getIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *ProjectsLocationsRestorePlansGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &Policy{ + 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 access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.restorePlans.getIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "options.requestedPolicyVersion": { + // "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:getIamPolicy", + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.restorePlans.list": + +type ProjectsLocationsRestorePlansListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists RestorePlans in a given location. +// +// - parent: The location that contains the RestorePlans to list. +// Format: projects/{project}/locations/{location}. +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. +func (c *ProjectsLocationsRestorePlansListCall) Filter(filter string) *ProjectsLocationsRestorePlansListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": Sort results. +func (c *ProjectsLocationsRestorePlansListCall) OrderBy(orderBy string) *ProjectsLocationsRestorePlansListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": The target number of +// results to return in a single response. If not specified, a default +// value will be chosen by the service. Note that the response may +// inclue a partial list and a caller should only rely on the response's +// next_page_token to determine if there are more instances left to be +// queried. +func (c *ProjectsLocationsRestorePlansListCall) PageSize(pageSize int64) *ProjectsLocationsRestorePlansListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The value of +// next_page_token received from a previous `ListRestorePlans` call. +// Provide this to retrieve the subsequent page in a multi-page list of +// results. When paginating, all other parameters provided to +// `ListRestorePlans` must match the call that provided the page token. +func (c *ProjectsLocationsRestorePlansListCall) PageToken(pageToken string) *ProjectsLocationsRestorePlansListCall { + 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 *ProjectsLocationsRestorePlansListCall) Fields(s ...googleapi.Field) *ProjectsLocationsRestorePlansListCall { + 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 *ProjectsLocationsRestorePlansListCall) IfNoneMatch(entityTag string) *ProjectsLocationsRestorePlansListCall { + 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 *ProjectsLocationsRestorePlansListCall) Context(ctx context.Context) *ProjectsLocationsRestorePlansListCall { + 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 *ProjectsLocationsRestorePlansListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRestorePlansListCall) 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, "v1/{+parent}/restorePlans") + 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 "gkebackup.projects.locations.restorePlans.list" call. +// Exactly one of *ListRestorePlansResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *ListRestorePlansResponse.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 *ProjectsLocationsRestorePlansListCall) Do(opts ...googleapi.CallOption) (*ListRestorePlansResponse, 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 := &ListRestorePlansResponse{ + 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 RestorePlans in a given location.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.restorePlans.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "filter": { + // "description": "List filter.", + // "location": "query", + // "type": "string" + // }, + // "orderBy": { + // "description": "Sort results.", + // "location": "query", + // "type": "string" + // }, + // "pageSize": { + // "description": "The target number of results to return in a single response. If not specified, a default value will be chosen by the service. Note that the response may inclue a partial list and a caller should only rely on the response's next_page_token to determine if there are more instances left to be queried.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The value of next_page_token received from a previous `ListRestorePlans` call. Provide this to retrieve the subsequent page in a multi-page list of results. When paginating, all other parameters provided to `ListRestorePlans` must match the call that provided the page token.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The location that contains the RestorePlans to list. Format: projects/{project}/locations/{location}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/restorePlans", + // "response": { + // "$ref": "ListRestorePlansResponse" + // }, + // "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 *ProjectsLocationsRestorePlansListCall) Pages(ctx context.Context, f func(*ListRestorePlansResponse) 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 "gkebackup.projects.locations.restorePlans.patch": + +type ProjectsLocationsRestorePlansPatchCall struct { + s *Service + name string + restoreplan *RestorePlan + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Update a RestorePlan. +// +// - name: Output only. [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 + c.restoreplan = restoreplan + return c +} + +// UpdateMask sets the optional parameter "updateMask": This is used to +// specify the fields to be overwritten in the RestorePlan targeted for +// update. The values for each of these updated fields will be taken +// from the `restore_plan` provided with this request. Field names are +// relative to the root of the resource. If no `update_mask` is +// provided, all fields in `restore_plan` will be written to the target +// RestorePlan resource. Note that OUTPUT_ONLY and IMMUTABLE fields in +// `restore_plan` are ignored and are not used to update the target +// RestorePlan. +func (c *ProjectsLocationsRestorePlansPatchCall) UpdateMask(updateMask string) *ProjectsLocationsRestorePlansPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsRestorePlansPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsRestorePlansPatchCall { + 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 *ProjectsLocationsRestorePlansPatchCall) Context(ctx context.Context) *ProjectsLocationsRestorePlansPatchCall { + 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 *ProjectsLocationsRestorePlansPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRestorePlansPatchCall) 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.restoreplan) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.restorePlans.patch" 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 *ProjectsLocationsRestorePlansPatchCall) 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": "Update a RestorePlan.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}", + // "httpMethod": "PATCH", + // "id": "gkebackup.projects.locations.restorePlans.patch", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Output only. [Output Only] The full name of the RestorePlan resource. Format: projects/*/locations/*/restorePlans/*", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "This is used to specify the fields to be overwritten in the RestorePlan targeted for update. The values for each of these updated fields will be taken from the `restore_plan` provided with this request. Field names are relative to the root of the resource. If no `update_mask` is provided, all fields in `restore_plan` will be written to the target RestorePlan resource. Note that OUTPUT_ONLY and IMMUTABLE fields in `restore_plan` are ignored and are not used to update the target RestorePlan.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "request": { + // "$ref": "RestorePlan" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.restorePlans.setIamPolicy": + +type ProjectsLocationsRestorePlansSetIamPolicyCall struct { + s *Service + resource string + setiampolicyrequest *SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy. Can return `NOT_FOUND`, +// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. +// +// - resource: REQUIRED: The resource for which the policy is being +// specified. See the operation documentation for the appropriate +// value for this field. +func (r *ProjectsLocationsRestorePlansService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsRestorePlansSetIamPolicyCall { + c := &ProjectsLocationsRestorePlansSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.setiampolicyrequest = setiampolicyrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsRestorePlansSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsRestorePlansSetIamPolicyCall { + 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 *ProjectsLocationsRestorePlansSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsRestorePlansSetIamPolicyCall { + 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 *ProjectsLocationsRestorePlansSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRestorePlansSetIamPolicyCall) 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.setiampolicyrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:setIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.restorePlans.setIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *ProjectsLocationsRestorePlansSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &Policy{ + 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": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}:setIamPolicy", + // "httpMethod": "POST", + // "id": "gkebackup.projects.locations.restorePlans.setIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:setIamPolicy", + // "request": { + // "$ref": "SetIamPolicyRequest" + // }, + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.restorePlans.testIamPermissions": + +type ProjectsLocationsRestorePlansTestIamPermissionsCall struct { + s *Service + resource string + testiampermissionsrequest *TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a `NOT_FOUND` error. Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See the operation documentation for the +// appropriate value for this field. +func (r *ProjectsLocationsRestorePlansService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsRestorePlansTestIamPermissionsCall { + c := &ProjectsLocationsRestorePlansTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.testiampermissionsrequest = testiampermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsRestorePlansTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsRestorePlansTestIamPermissionsCall { + 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 *ProjectsLocationsRestorePlansTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsRestorePlansTestIamPermissionsCall { + 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 *ProjectsLocationsRestorePlansTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRestorePlansTestIamPermissionsCall) 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.testiampermissionsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:testIamPermissions") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.restorePlans.testIamPermissions" call. +// Exactly one of *TestIamPermissionsResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *TestIamPermissionsResponse.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *ProjectsLocationsRestorePlansTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &TestIamPermissionsResponse{ + 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": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "gkebackup.projects.locations.restorePlans.testIamPermissions", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "TestIamPermissionsRequest" + // }, + // "response": { + // "$ref": "TestIamPermissionsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.restorePlans.restores.create": + +type ProjectsLocationsRestorePlansRestoresCreateCall struct { + s *Service + parent string + restore *Restore + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// 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}. +func (r *ProjectsLocationsRestorePlansRestoresService) Create(parent string, restore *Restore) *ProjectsLocationsRestorePlansRestoresCreateCall { + c := &ProjectsLocationsRestorePlansRestoresCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.restore = restore + return c +} + +// 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 +// unique within the set of Restores in this RestorePlan. +func (c *ProjectsLocationsRestorePlansRestoresCreateCall) RestoreId(restoreId string) *ProjectsLocationsRestorePlansRestoresCreateCall { + c.urlParams_.Set("restoreId", restoreId) + 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 *ProjectsLocationsRestorePlansRestoresCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsRestorePlansRestoresCreateCall { + 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 *ProjectsLocationsRestorePlansRestoresCreateCall) Context(ctx context.Context) *ProjectsLocationsRestorePlansRestoresCreateCall { + 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 *ProjectsLocationsRestorePlansRestoresCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRestorePlansRestoresCreateCall) 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.restore) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/restores") + 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 "gkebackup.projects.locations.restorePlans.restores.create" 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 *ProjectsLocationsRestorePlansRestoresCreateCall) 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 new Restore for the given RestorePlan.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores", + // "httpMethod": "POST", + // "id": "gkebackup.projects.locations.restorePlans.restores.create", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "Required. The RestorePlan within which to create the Restore. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}", + // "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.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/restores", + // "request": { + // "$ref": "Restore" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.restorePlans.restores.delete": + +type ProjectsLocationsRestorePlansRestoresDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes an existing Restore. +// +// - name: Full name of the Restore Format: +// projects/{project}/locations/{location}/restorePlans/{restore_plan}/ +// restores/{restore}. +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. +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. +func (c *ProjectsLocationsRestorePlansRestoresDeleteCall) Force(force bool) *ProjectsLocationsRestorePlansRestoresDeleteCall { + c.urlParams_.Set("force", fmt.Sprint(force)) + 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 *ProjectsLocationsRestorePlansRestoresDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsRestorePlansRestoresDeleteCall { + 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 *ProjectsLocationsRestorePlansRestoresDeleteCall) Context(ctx context.Context) *ProjectsLocationsRestorePlansRestoresDeleteCall { + 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 *ProjectsLocationsRestorePlansRestoresDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRestorePlansRestoresDeleteCall) 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, "v1/{+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 "gkebackup.projects.locations.restorePlans.restores.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 *ProjectsLocationsRestorePlansRestoresDeleteCall) 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 an existing Restore.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}", + // "httpMethod": "DELETE", + // "id": "gkebackup.projects.locations.restorePlans.restores.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "etag": { + // "description": "etag, if provided, it must match the server's etag for delete to happen.", + // "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.", + // "location": "query", + // "type": "boolean" + // }, + // "name": { + // "description": "Required. Full name of the Restore Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}/restores/{restore}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.restorePlans.restores.get": + +type ProjectsLocationsRestorePlansRestoresGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Retrieves the details of a single Restore. +// +// - name: Name of the restore resource. Format: +// projects/{project}/locations/{location}/restorePlans/{restore_plan}/ +// restores/{restore}. +func (r *ProjectsLocationsRestorePlansRestoresService) Get(name string) *ProjectsLocationsRestorePlansRestoresGetCall { + c := &ProjectsLocationsRestorePlansRestoresGetCall{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 *ProjectsLocationsRestorePlansRestoresGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsRestorePlansRestoresGetCall { + 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 *ProjectsLocationsRestorePlansRestoresGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsRestorePlansRestoresGetCall { + 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 *ProjectsLocationsRestorePlansRestoresGetCall) Context(ctx context.Context) *ProjectsLocationsRestorePlansRestoresGetCall { + 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 *ProjectsLocationsRestorePlansRestoresGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRestorePlansRestoresGetCall) 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, "v1/{+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 "gkebackup.projects.locations.restorePlans.restores.get" call. +// Exactly one of *Restore or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Restore.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 *ProjectsLocationsRestorePlansRestoresGetCall) Do(opts ...googleapi.CallOption) (*Restore, 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 := &Restore{ + 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 details of a single Restore.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.restorePlans.restores.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. Name of the restore resource. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}/restores/{restore}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Restore" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.restorePlans.restores.getIamPolicy": + +type ProjectsLocationsRestorePlansRestoresGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. +// +// - resource: REQUIRED: The resource for which the policy is being +// requested. See the operation documentation for the appropriate +// value for this field. +func (r *ProjectsLocationsRestorePlansRestoresService) GetIamPolicy(resource string) *ProjectsLocationsRestorePlansRestoresGetIamPolicyCall { + c := &ProjectsLocationsRestorePlansRestoresGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + return c +} + +// OptionsRequestedPolicyVersion sets the optional parameter +// "options.requestedPolicyVersion": The maximum policy version that +// will be used to format the policy. Valid values are 0, 1, and 3. +// Requests specifying an invalid value will be rejected. Requests for +// policies with any conditional role bindings must specify version 3. +// Policies with no conditional role bindings may specify any valid +// value or leave the field unset. The policy in the response might use +// the policy version that you specified, or it might use a lower policy +// version. For example, if you specify version 3, but the policy has no +// conditional role bindings, the response uses version 1. To learn +// which resources support conditions in their IAM policies, see the IAM +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +func (c *ProjectsLocationsRestorePlansRestoresGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsRestorePlansRestoresGetIamPolicyCall { + c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsRestorePlansRestoresGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsRestorePlansRestoresGetIamPolicyCall { + 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 *ProjectsLocationsRestorePlansRestoresGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsRestorePlansRestoresGetIamPolicyCall { + 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 *ProjectsLocationsRestorePlansRestoresGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsRestorePlansRestoresGetIamPolicyCall { + 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 *ProjectsLocationsRestorePlansRestoresGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRestorePlansRestoresGetIamPolicyCall) 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, "v1/{+resource}:getIamPolicy") + 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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.restorePlans.restores.getIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *ProjectsLocationsRestorePlansRestoresGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &Policy{ + 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 access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.restorePlans.restores.getIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "options.requestedPolicyVersion": { + // "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:getIamPolicy", + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.restorePlans.restores.list": + +type ProjectsLocationsRestorePlansRestoresListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// 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}. +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. +func (c *ProjectsLocationsRestorePlansRestoresListCall) Filter(filter string) *ProjectsLocationsRestorePlansRestoresListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": Sort results. +func (c *ProjectsLocationsRestorePlansRestoresListCall) OrderBy(orderBy string) *ProjectsLocationsRestorePlansRestoresListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": The target number of +// results to return in a single response. If not specified, a default +// value will be chosen by the service. Note that the response may +// inclue a partial list and a caller should only rely on the response's +// next_page_token to determine if there are more instances left to be +// queried. +func (c *ProjectsLocationsRestorePlansRestoresListCall) PageSize(pageSize int64) *ProjectsLocationsRestorePlansRestoresListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The value of +// next_page_token received from a previous `ListRestores` call. Provide +// this to retrieve the subsequent page in a multi-page list of results. +// When paginating, all other parameters provided to `ListRestores` must +// match the call that provided the page token. +func (c *ProjectsLocationsRestorePlansRestoresListCall) PageToken(pageToken string) *ProjectsLocationsRestorePlansRestoresListCall { + 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 *ProjectsLocationsRestorePlansRestoresListCall) Fields(s ...googleapi.Field) *ProjectsLocationsRestorePlansRestoresListCall { + 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 *ProjectsLocationsRestorePlansRestoresListCall) IfNoneMatch(entityTag string) *ProjectsLocationsRestorePlansRestoresListCall { + 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 *ProjectsLocationsRestorePlansRestoresListCall) Context(ctx context.Context) *ProjectsLocationsRestorePlansRestoresListCall { + 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 *ProjectsLocationsRestorePlansRestoresListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRestorePlansRestoresListCall) 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, "v1/{+parent}/restores") + 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 "gkebackup.projects.locations.restorePlans.restores.list" call. +// Exactly one of *ListRestoresResponse or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *ListRestoresResponse.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 *ProjectsLocationsRestorePlansRestoresListCall) Do(opts ...googleapi.CallOption) (*ListRestoresResponse, 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 := &ListRestoresResponse{ + 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 the Restores for a given RestorePlan.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.restorePlans.restores.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "filter": { + // "description": "List filter.", + // "location": "query", + // "type": "string" + // }, + // "orderBy": { + // "description": "Sort results.", + // "location": "query", + // "type": "string" + // }, + // "pageSize": { + // "description": "The target number of results to return in a single response. If not specified, a default value will be chosen by the service. Note that the response may inclue a partial list and a caller should only rely on the response's next_page_token to determine if there are more instances left to be queried.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The value of next_page_token received from a previous `ListRestores` call. Provide this to retrieve the subsequent page in a multi-page list of results. When paginating, all other parameters provided to `ListRestores` must match the call that provided the page token.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The RestorePlan that contains the Restores to list. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/restores", + // "response": { + // "$ref": "ListRestoresResponse" + // }, + // "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 *ProjectsLocationsRestorePlansRestoresListCall) Pages(ctx context.Context, f func(*ListRestoresResponse) 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 "gkebackup.projects.locations.restorePlans.restores.patch": + +type ProjectsLocationsRestorePlansRestoresPatchCall struct { + s *Service + name string + restore *Restore + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Update a Restore. +// +// - name: Output only. The full name of the Restore resource. Format: +// projects/*/locations/*/restorePlans/*/restores/*. +func (r *ProjectsLocationsRestorePlansRestoresService) Patch(name string, restore *Restore) *ProjectsLocationsRestorePlansRestoresPatchCall { + c := &ProjectsLocationsRestorePlansRestoresPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.restore = restore + return c +} + +// UpdateMask sets the optional parameter "updateMask": This is used to +// specify the fields to be overwritten in the Restore targeted for +// update. The values for each of these updated fields will be taken +// from the `restore` provided with this request. Field names are +// relative to the root of the resource. If no `update_mask` is +// provided, all fields in `restore` will be written to the target +// Restore resource. Note that OUTPUT_ONLY and IMMUTABLE fields in +// `restore` are ignored and are not used to update the target Restore. +func (c *ProjectsLocationsRestorePlansRestoresPatchCall) UpdateMask(updateMask string) *ProjectsLocationsRestorePlansRestoresPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsRestorePlansRestoresPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsRestorePlansRestoresPatchCall { + 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 *ProjectsLocationsRestorePlansRestoresPatchCall) Context(ctx context.Context) *ProjectsLocationsRestorePlansRestoresPatchCall { + 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 *ProjectsLocationsRestorePlansRestoresPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRestorePlansRestoresPatchCall) 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.restore) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.restorePlans.restores.patch" 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 *ProjectsLocationsRestorePlansRestoresPatchCall) 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": "Update a Restore.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}", + // "httpMethod": "PATCH", + // "id": "gkebackup.projects.locations.restorePlans.restores.patch", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Output only. The full name of the Restore resource. Format: projects/*/locations/*/restorePlans/*/restores/*", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "This is used to specify the fields to be overwritten in the Restore targeted for update. The values for each of these updated fields will be taken from the `restore` provided with this request. Field names are relative to the root of the resource. If no `update_mask` is provided, all fields in `restore` will be written to the target Restore resource. Note that OUTPUT_ONLY and IMMUTABLE fields in `restore` are ignored and are not used to update the target Restore.", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "request": { + // "$ref": "Restore" + // }, + // "response": { + // "$ref": "GoogleLongrunningOperation" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.restorePlans.restores.setIamPolicy": + +type ProjectsLocationsRestorePlansRestoresSetIamPolicyCall struct { + s *Service + resource string + setiampolicyrequest *SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy. Can return `NOT_FOUND`, +// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. +// +// - resource: REQUIRED: The resource for which the policy is being +// specified. See the operation documentation for the appropriate +// value for this field. +func (r *ProjectsLocationsRestorePlansRestoresService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsRestorePlansRestoresSetIamPolicyCall { + c := &ProjectsLocationsRestorePlansRestoresSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.setiampolicyrequest = setiampolicyrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsRestorePlansRestoresSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsRestorePlansRestoresSetIamPolicyCall { + 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 *ProjectsLocationsRestorePlansRestoresSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsRestorePlansRestoresSetIamPolicyCall { + 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 *ProjectsLocationsRestorePlansRestoresSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRestorePlansRestoresSetIamPolicyCall) 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.setiampolicyrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:setIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.restorePlans.restores.setIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *ProjectsLocationsRestorePlansRestoresSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &Policy{ + 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": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}:setIamPolicy", + // "httpMethod": "POST", + // "id": "gkebackup.projects.locations.restorePlans.restores.setIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:setIamPolicy", + // "request": { + // "$ref": "SetIamPolicyRequest" + // }, + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.restorePlans.restores.testIamPermissions": + +type ProjectsLocationsRestorePlansRestoresTestIamPermissionsCall struct { + s *Service + resource string + testiampermissionsrequest *TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a `NOT_FOUND` error. Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See the operation documentation for the +// appropriate value for this field. +func (r *ProjectsLocationsRestorePlansRestoresService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsRestorePlansRestoresTestIamPermissionsCall { + c := &ProjectsLocationsRestorePlansRestoresTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.testiampermissionsrequest = testiampermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsRestorePlansRestoresTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsRestorePlansRestoresTestIamPermissionsCall { + 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 *ProjectsLocationsRestorePlansRestoresTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsRestorePlansRestoresTestIamPermissionsCall { + 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 *ProjectsLocationsRestorePlansRestoresTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRestorePlansRestoresTestIamPermissionsCall) 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.testiampermissionsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:testIamPermissions") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.restorePlans.restores.testIamPermissions" call. +// Exactly one of *TestIamPermissionsResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *TestIamPermissionsResponse.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *ProjectsLocationsRestorePlansRestoresTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &TestIamPermissionsResponse{ + 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": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "gkebackup.projects.locations.restorePlans.restores.testIamPermissions", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "TestIamPermissionsRequest" + // }, + // "response": { + // "$ref": "TestIamPermissionsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.restorePlans.restores.volumeRestores.get": + +type ProjectsLocationsRestorePlansRestoresVolumeRestoresGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// 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}. +func (r *ProjectsLocationsRestorePlansRestoresVolumeRestoresService) Get(name string) *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetCall { + c := &ProjectsLocationsRestorePlansRestoresVolumeRestoresGetCall{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 *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetCall { + 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 *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetCall { + 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 *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetCall) Context(ctx context.Context) *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetCall { + 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 *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetCall) 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, "v1/{+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 "gkebackup.projects.locations.restorePlans.restores.volumeRestores.get" call. +// Exactly one of *VolumeRestore or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *VolumeRestore.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 *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetCall) Do(opts ...googleapi.CallOption) (*VolumeRestore, 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 := &VolumeRestore{ + 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": "Retrieve the details of a single VolumeRestore.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}/volumeRestores/{volumeRestoresId}", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.restorePlans.restores.volumeRestores.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "Required. Full name of the VolumeRestore resource. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}/restores/{restore}/volumeRestores/{volume_restore}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+/volumeRestores/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "VolumeRestore" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.restorePlans.restores.volumeRestores.getIamPolicy": + +type ProjectsLocationsRestorePlansRestoresVolumeRestoresGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. +// +// - resource: REQUIRED: The resource for which the policy is being +// requested. See the operation documentation for the appropriate +// value for this field. +func (r *ProjectsLocationsRestorePlansRestoresVolumeRestoresService) GetIamPolicy(resource string) *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetIamPolicyCall { + c := &ProjectsLocationsRestorePlansRestoresVolumeRestoresGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + return c +} + +// OptionsRequestedPolicyVersion sets the optional parameter +// "options.requestedPolicyVersion": The maximum policy version that +// will be used to format the policy. Valid values are 0, 1, and 3. +// Requests specifying an invalid value will be rejected. Requests for +// policies with any conditional role bindings must specify version 3. +// Policies with no conditional role bindings may specify any valid +// value or leave the field unset. The policy in the response might use +// the policy version that you specified, or it might use a lower policy +// version. For example, if you specify version 3, but the policy has no +// conditional role bindings, the response uses version 1. To learn +// which resources support conditions in their IAM policies, see the IAM +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +func (c *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetIamPolicyCall { + c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetIamPolicyCall { + 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 *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetIamPolicyCall { + 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 *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetIamPolicyCall { + 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 *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetIamPolicyCall) 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, "v1/{+resource}:getIamPolicy") + 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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.restorePlans.restores.volumeRestores.getIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *ProjectsLocationsRestorePlansRestoresVolumeRestoresGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &Policy{ + 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 access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}/volumeRestores/{volumeRestoresId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.restorePlans.restores.volumeRestores.getIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "options.requestedPolicyVersion": { + // "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+/volumeRestores/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:getIamPolicy", + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.restorePlans.restores.volumeRestores.list": + +type ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// 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}. +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. +func (c *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall) Filter(filter string) *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall { + c.urlParams_.Set("filter", filter) + return c +} + +// OrderBy sets the optional parameter "orderBy": Sort results. +func (c *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall) OrderBy(orderBy string) *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall { + c.urlParams_.Set("orderBy", orderBy) + return c +} + +// PageSize sets the optional parameter "pageSize": The target number of +// results to return in a single response. If not specified, a default +// value will be chosen by the service. Note that the response may +// inclue a partial list and a caller should only rely on the response's +// next_page_token to determine if there are more instances left to be +// queried. +func (c *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall) PageSize(pageSize int64) *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The value of +// next_page_token received from a previous `ListVolumeRestores` call. +// Provide this to retrieve the subsequent page in a multi-page list of +// results. When paginating, all other parameters provided to +// `ListVolumeRestores` must match the call that provided the page +// token. +func (c *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall) PageToken(pageToken string) *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall { + 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 *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall) Fields(s ...googleapi.Field) *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall { + 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 *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall) IfNoneMatch(entityTag string) *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall { + 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 *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall) Context(ctx context.Context) *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall { + 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 *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall) 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, "v1/{+parent}/volumeRestores") + 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 "gkebackup.projects.locations.restorePlans.restores.volumeRestores.list" call. +// Exactly one of *ListVolumeRestoresResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *ListVolumeRestoresResponse.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 *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall) Do(opts ...googleapi.CallOption) (*ListVolumeRestoresResponse, 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 := &ListVolumeRestoresResponse{ + 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 the VolumeRestores for a given Restore.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}/volumeRestores", + // "httpMethod": "GET", + // "id": "gkebackup.projects.locations.restorePlans.restores.volumeRestores.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "filter": { + // "description": "List filter.", + // "location": "query", + // "type": "string" + // }, + // "orderBy": { + // "description": "Sort results.", + // "location": "query", + // "type": "string" + // }, + // "pageSize": { + // "description": "The target number of results to return in a single response. If not specified, a default value will be chosen by the service. Note that the response may inclue a partial list and a caller should only rely on the response's next_page_token to determine if there are more instances left to be queried.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The value of next_page_token received from a previous `ListVolumeRestores` call. Provide this to retrieve the subsequent page in a multi-page list of results. When paginating, all other parameters provided to `ListVolumeRestores` must match the call that provided the page token.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The Restore that contains the VolumeRestores to list. Format: projects/{project}/locations/{location}/restorePlans/{restore_plan}/restores/{restore}", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/volumeRestores", + // "response": { + // "$ref": "ListVolumeRestoresResponse" + // }, + // "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 *ProjectsLocationsRestorePlansRestoresVolumeRestoresListCall) Pages(ctx context.Context, f func(*ListVolumeRestoresResponse) 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 "gkebackup.projects.locations.restorePlans.restores.volumeRestores.setIamPolicy": + +type ProjectsLocationsRestorePlansRestoresVolumeRestoresSetIamPolicyCall struct { + s *Service + resource string + setiampolicyrequest *SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy. Can return `NOT_FOUND`, +// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. +// +// - resource: REQUIRED: The resource for which the policy is being +// specified. See the operation documentation for the appropriate +// value for this field. +func (r *ProjectsLocationsRestorePlansRestoresVolumeRestoresService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsRestorePlansRestoresVolumeRestoresSetIamPolicyCall { + c := &ProjectsLocationsRestorePlansRestoresVolumeRestoresSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.setiampolicyrequest = setiampolicyrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsRestorePlansRestoresVolumeRestoresSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsRestorePlansRestoresVolumeRestoresSetIamPolicyCall { + 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 *ProjectsLocationsRestorePlansRestoresVolumeRestoresSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsRestorePlansRestoresVolumeRestoresSetIamPolicyCall { + 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 *ProjectsLocationsRestorePlansRestoresVolumeRestoresSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRestorePlansRestoresVolumeRestoresSetIamPolicyCall) 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.setiampolicyrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:setIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.restorePlans.restores.volumeRestores.setIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *ProjectsLocationsRestorePlansRestoresVolumeRestoresSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &Policy{ + 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": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}/volumeRestores/{volumeRestoresId}:setIamPolicy", + // "httpMethod": "POST", + // "id": "gkebackup.projects.locations.restorePlans.restores.volumeRestores.setIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+/volumeRestores/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:setIamPolicy", + // "request": { + // "$ref": "SetIamPolicyRequest" + // }, + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "gkebackup.projects.locations.restorePlans.restores.volumeRestores.testIamPermissions": + +type ProjectsLocationsRestorePlansRestoresVolumeRestoresTestIamPermissionsCall struct { + s *Service + resource string + testiampermissionsrequest *TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a `NOT_FOUND` error. Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See the operation documentation for the +// appropriate value for this field. +func (r *ProjectsLocationsRestorePlansRestoresVolumeRestoresService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsRestorePlansRestoresVolumeRestoresTestIamPermissionsCall { + c := &ProjectsLocationsRestorePlansRestoresVolumeRestoresTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.testiampermissionsrequest = testiampermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsRestorePlansRestoresVolumeRestoresTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsRestorePlansRestoresVolumeRestoresTestIamPermissionsCall { + 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 *ProjectsLocationsRestorePlansRestoresVolumeRestoresTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsRestorePlansRestoresVolumeRestoresTestIamPermissionsCall { + 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 *ProjectsLocationsRestorePlansRestoresVolumeRestoresTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsRestorePlansRestoresVolumeRestoresTestIamPermissionsCall) 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.testiampermissionsrequest) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+resource}:testIamPermissions") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "gkebackup.projects.locations.restorePlans.restores.volumeRestores.testIamPermissions" call. +// Exactly one of *TestIamPermissionsResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *TestIamPermissionsResponse.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *ProjectsLocationsRestorePlansRestoresVolumeRestoresTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &TestIamPermissionsResponse{ + 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": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/restorePlans/{restorePlansId}/restores/{restoresId}/volumeRestores/{volumeRestoresId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "gkebackup.projects.locations.restorePlans.restores.volumeRestores.testIamPermissions", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/restorePlans/[^/]+/restores/[^/]+/volumeRestores/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "TestIamPermissionsRequest" + // }, + // "response": { + // "$ref": "TestIamPermissionsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} diff --git a/gkehub/v1/gkehub-api.json b/gkehub/v1/gkehub-api.json index 4f06167108d..1b73272573f 100644 --- a/gkehub/v1/gkehub-api.json +++ b/gkehub/v1/gkehub-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" }, @@ -905,7 +905,7 @@ } } }, - "revision": "20220318", + "revision": "20220408", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AppDevExperienceFeatureSpec": { @@ -1008,7 +1008,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" }, @@ -2235,6 +2235,10 @@ "configmanagement": { "$ref": "ConfigManagementMembershipSpec", "description": "Config Management-specific spec." + }, + "mesh": { + "$ref": "ServiceMeshMembershipSpec", + "description": "Anthos Service Mesh-specific spec" } }, "type": "object" @@ -2251,6 +2255,10 @@ "$ref": "ConfigManagementMembershipState", "description": "Config Management-specific state." }, + "servicemesh": { + "$ref": "ServiceMeshMembershipState", + "description": "Service Mesh-specific state." + }, "state": { "$ref": "FeatureState", "description": "The high-level state of this Feature for a single membership." @@ -2477,13 +2485,99 @@ }, "type": "object" }, + "ServiceMeshControlPlaneManagement": { + "description": "Status of control plane management.", + "id": "ServiceMeshControlPlaneManagement", + "properties": { + "details": { + "description": "Explanation of state.", + "items": { + "$ref": "ServiceMeshStatusDetails" + }, + "type": "array" + }, + "state": { + "description": "LifecycleState of control plane management.", + "enum": [ + "LIFECYCLE_STATE_UNSPECIFIED", + "DISABLED", + "FAILED_PRECONDITION", + "PROVISIONING", + "ACTIVE", + "STALLED", + "NEEDS_ATTENTION", + "DEGRADED" + ], + "enumDescriptions": [ + "Unspecified", + "DISABLED means that the component is not enabled.", + "FAILED_PRECONDITION means that provisioning cannot proceed because of some characteristic of the member cluster.", + "PROVISIONING means that provisioning is in progress.", + "ACTIVE means that the component is ready for use.", + "STALLED means that provisioning could not be done.", + "NEEDS_ATTENTION means that the component is ready, but some user intervention is required. (For example that the user should migrate workloads to a new control plane revision.)", + "DEGRADED means that the component is ready, but operating in a degraded state." + ], + "type": "string" + } + }, + "type": "object" + }, + "ServiceMeshMembershipSpec": { + "description": "**Service Mesh**: Spec for a single Membership for the servicemesh feature", + "id": "ServiceMeshMembershipSpec", + "properties": { + "controlPlane": { + "description": "Enables automatic control plane management.", + "enum": [ + "CONTROL_PLANE_MANAGEMENT_UNSPECIFIED", + "AUTOMATIC", + "MANUAL" + ], + "enumDescriptions": [ + "Unspecified", + "Google should provision a control plane revision and make it available in the cluster. Google will enroll this revision in a release channel and keep it up to date. The control plane revision may be a managed service, or a managed install.", + "User will manually configure the control plane (e.g. via CLI, or via the ControlPlaneRevision KRM API)" + ], + "type": "string" + } + }, + "type": "object" + }, + "ServiceMeshMembershipState": { + "description": "**Service Mesh**: State for a single Membership, as analyzed by the Service Mesh Hub Controller.", + "id": "ServiceMeshMembershipState", + "properties": { + "controlPlaneManagement": { + "$ref": "ServiceMeshControlPlaneManagement", + "description": "Output only. Status of control plane management", + "readOnly": true + } + }, + "type": "object" + }, + "ServiceMeshStatusDetails": { + "description": "Structured and human-readable details for a status.", + "id": "ServiceMeshStatusDetails", + "properties": { + "code": { + "description": "A machine-readable code that further describes a broad status.", + "type": "string" + }, + "details": { + "description": "Human-readable explanation of code.", + "type": "string" + } + }, + "type": "object" + }, "SetIamPolicyRequest": { "description": "Request message for `SetIamPolicy` method.", "id": "SetIamPolicyRequest", "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\"`", @@ -2525,7 +2619,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/gkehub/v1/gkehub-gen.go b/gkehub/v1/gkehub-gen.go index 942f1414eac..5907d8bea5d 100644 --- a/gkehub/v1/gkehub-gen.go +++ b/gkehub/v1/gkehub-gen.go @@ -396,8 +396,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 @@ -2357,6 +2357,9 @@ type MembershipFeatureSpec struct { // Configmanagement: Config Management-specific spec. Configmanagement *ConfigManagementMembershipSpec `json:"configmanagement,omitempty"` + // Mesh: Anthos Service Mesh-specific spec + Mesh *ServiceMeshMembershipSpec `json:"mesh,omitempty"` + // ForceSendFields is a list of field names (e.g. "Configmanagement") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -2390,6 +2393,9 @@ type MembershipFeatureState struct { // Configmanagement: Config Management-specific state. Configmanagement *ConfigManagementMembershipState `json:"configmanagement,omitempty"` + // Servicemesh: Service Mesh-specific state. + Servicemesh *ServiceMeshMembershipState `json:"servicemesh,omitempty"` + // State: The high-level state of this Feature for a single membership. State *FeatureState `json:"state,omitempty"` @@ -2873,11 +2879,160 @@ func (s *ResourceOptions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ServiceMeshControlPlaneManagement: Status of control plane +// management. +type ServiceMeshControlPlaneManagement struct { + // Details: Explanation of state. + Details []*ServiceMeshStatusDetails `json:"details,omitempty"` + + // State: LifecycleState of control plane management. + // + // Possible values: + // "LIFECYCLE_STATE_UNSPECIFIED" - Unspecified + // "DISABLED" - DISABLED means that the component is not enabled. + // "FAILED_PRECONDITION" - FAILED_PRECONDITION means that provisioning + // cannot proceed because of some characteristic of the member cluster. + // "PROVISIONING" - PROVISIONING means that provisioning is in + // progress. + // "ACTIVE" - ACTIVE means that the component is ready for use. + // "STALLED" - STALLED means that provisioning could not be done. + // "NEEDS_ATTENTION" - NEEDS_ATTENTION means that the component is + // ready, but some user intervention is required. (For example that the + // user should migrate workloads to a new control plane revision.) + // "DEGRADED" - DEGRADED means that the component is ready, but + // operating in a degraded state. + State string `json:"state,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Details") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. 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. "Details") 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 *ServiceMeshControlPlaneManagement) MarshalJSON() ([]byte, error) { + type NoMethod ServiceMeshControlPlaneManagement + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ServiceMeshMembershipSpec: **Service Mesh**: Spec for a single +// Membership for the servicemesh feature +type ServiceMeshMembershipSpec struct { + // ControlPlane: Enables automatic control plane management. + // + // Possible values: + // "CONTROL_PLANE_MANAGEMENT_UNSPECIFIED" - Unspecified + // "AUTOMATIC" - Google should provision a control plane revision and + // make it available in the cluster. Google will enroll this revision in + // a release channel and keep it up to date. The control plane revision + // may be a managed service, or a managed install. + // "MANUAL" - User will manually configure the control plane (e.g. via + // CLI, or via the ControlPlaneRevision KRM API) + ControlPlane string `json:"controlPlane,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ControlPlane") 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. "ControlPlane") 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 *ServiceMeshMembershipSpec) MarshalJSON() ([]byte, error) { + type NoMethod ServiceMeshMembershipSpec + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ServiceMeshMembershipState: **Service Mesh**: State for a single +// Membership, as analyzed by the Service Mesh Hub Controller. +type ServiceMeshMembershipState struct { + // ControlPlaneManagement: Output only. Status of control plane + // management + ControlPlaneManagement *ServiceMeshControlPlaneManagement `json:"controlPlaneManagement,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "ControlPlaneManagement") 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. "ControlPlaneManagement") + // 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 *ServiceMeshMembershipState) MarshalJSON() ([]byte, error) { + type NoMethod ServiceMeshMembershipState + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ServiceMeshStatusDetails: Structured and human-readable details for a +// status. +type ServiceMeshStatusDetails struct { + // Code: A machine-readable code that further describes a broad status. + Code string `json:"code,omitempty"` + + // Details: Human-readable explanation of code. + Details string `json:"details,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 *ServiceMeshStatusDetails) MarshalJSON() ([]byte, error) { + type NoMethod ServiceMeshStatusDetails + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // SetIamPolicyRequest: Request message for `SetIamPolicy` method. type SetIamPolicyRequest struct { // Policy: REQUIRED: The complete policy to be applied to the // `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"` @@ -2957,7 +3112,7 @@ func (s *Status) 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"` @@ -3221,8 +3376,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 @@ -3351,7 +3506,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/gkehub/v1beta/gkehub-api.json b/gkehub/v1beta/gkehub-api.json index 9119c80fd96..98f9f6bdd6c 100644 --- a/gkehub/v1beta/gkehub-api.json +++ b/gkehub/v1beta/gkehub-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" }, @@ -670,7 +670,7 @@ } } }, - "revision": "20220318", + "revision": "20220401", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AnthosObservabilityFeatureSpec": { @@ -1794,7 +1794,7 @@ "type": "string" }, "clientSecret": { - "description": "Unencrypted OIDC client secret will be passed to the GKE Hub CLH.", + "description": "Input only. Unencrypted OIDC client secret will be passed to the GKE Hub CLH.", "type": "string" }, "deployCloudConsoleProxy": { diff --git a/gkehub/v1beta/gkehub-gen.go b/gkehub/v1beta/gkehub-gen.go index 0c002b57f0b..e3a4f9c05da 100644 --- a/gkehub/v1beta/gkehub-gen.go +++ b/gkehub/v1beta/gkehub-gen.go @@ -1988,8 +1988,8 @@ type IdentityServiceOidcConfig struct { // ClientId: ID for OIDC client application. ClientId string `json:"clientId,omitempty"` - // ClientSecret: Unencrypted OIDC client secret will be passed to the - // GKE Hub CLH. + // ClientSecret: Input only. Unencrypted OIDC client secret will be + // passed to the GKE Hub CLH. ClientSecret string `json:"clientSecret,omitempty"` // DeployCloudConsoleProxy: Flag to denote if reverse proxy is used to @@ -3242,8 +3242,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 @@ -3372,7 +3372,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/gkehub/v1beta1/gkehub-api.json b/gkehub/v1beta1/gkehub-api.json index 8de6cd2b53c..a280e50011f 100644 --- a/gkehub/v1beta1/gkehub-api.json +++ b/gkehub/v1beta1/gkehub-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" }, @@ -706,7 +706,7 @@ } } }, - "revision": "20220318", + "revision": "20220401", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AuditConfig": { diff --git a/gkehub/v1beta1/gkehub-gen.go b/gkehub/v1beta1/gkehub-gen.go index 396ff653614..afaddca3c25 100644 --- a/gkehub/v1beta1/gkehub-gen.go +++ b/gkehub/v1beta1/gkehub-gen.go @@ -1914,8 +1914,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 @@ -2044,7 +2044,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/lifesciences/v2beta/lifesciences-api.json b/lifesciences/v2beta/lifesciences-api.json index 8301a8405dc..d26ac6489c9 100644 --- a/lifesciences/v2beta/lifesciences-api.json +++ b/lifesciences/v2beta/lifesciences-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" }, @@ -312,7 +312,7 @@ } } }, - "revision": "20220325", + "revision": "20220401", "rootUrl": "https://lifesciences.googleapis.com/", "schemas": { "Accelerator": { diff --git a/lifesciences/v2beta/lifesciences-gen.go b/lifesciences/v2beta/lifesciences-gen.go index 68503b88e05..1a3add2ebd4 100644 --- a/lifesciences/v2beta/lifesciences-gen.go +++ b/lifesciences/v2beta/lifesciences-gen.go @@ -1970,8 +1970,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 @@ -2100,7 +2100,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/memcache/v1/memcache-api.json b/memcache/v1/memcache-api.json index c00e82567fd..39e146778e2 100644 --- a/memcache/v1/memcache-api.json +++ b/memcache/v1/memcache-api.json @@ -528,7 +528,7 @@ } } }, - "revision": "20220317", + "revision": "20220404", "rootUrl": "https://memcache.googleapis.com/", "schemas": { "ApplyParametersRequest": { @@ -760,9 +760,9 @@ }, "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": { @@ -905,6 +905,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/memcache/v1/memcache-gen.go b/memcache/v1/memcache-gen.go index 1b70bea2d1e..4db25c2929b 100644 --- a/memcache/v1/memcache-gen.go +++ b/memcache/v1/memcache-gen.go @@ -533,11 +533,11 @@ type GoogleCloudSaasacceleratorManagementProvidersV1Instance struct { // used, but keep it consistent with other APIs (e.g. RescheduleUpdate) 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 @@ -751,6 +751,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 { diff --git a/memcache/v1beta2/memcache-api.json b/memcache/v1beta2/memcache-api.json index acfbe6ea3e0..e95363046a9 100644 --- a/memcache/v1beta2/memcache-api.json +++ b/memcache/v1beta2/memcache-api.json @@ -556,7 +556,7 @@ } } }, - "revision": "20220317", + "revision": "20220404", "rootUrl": "https://memcache.googleapis.com/", "schemas": { "ApplyParametersRequest": { @@ -806,9 +806,9 @@ }, "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": { @@ -951,6 +951,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/memcache/v1beta2/memcache-gen.go b/memcache/v1beta2/memcache-gen.go index e4548ce239f..294b8e8b5a9 100644 --- a/memcache/v1beta2/memcache-gen.go +++ b/memcache/v1beta2/memcache-gen.go @@ -567,11 +567,11 @@ type GoogleCloudSaasacceleratorManagementProvidersV1Instance struct { // used, but keep it consistent with other APIs (e.g. RescheduleUpdate) 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 @@ -785,6 +785,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 { diff --git a/metastore/v1alpha/metastore-api.json b/metastore/v1alpha/metastore-api.json index 644cac77496..ed6c38635f9 100644 --- a/metastore/v1alpha/metastore-api.json +++ b/metastore/v1alpha/metastore-api.json @@ -1198,7 +1198,7 @@ } } }, - "revision": "20220127", + "revision": "20220331", "rootUrl": "https://metastore.googleapis.com/", "schemas": { "AuditConfig": { @@ -1438,7 +1438,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/metastore/v1alpha/metastore-gen.go b/metastore/v1alpha/metastore-gen.go index b5c72576141..9714044bd9b 100644 --- a/metastore/v1alpha/metastore-gen.go +++ b/metastore/v1alpha/metastore-gen.go @@ -661,8 +661,7 @@ func (s *DataplexConfig) 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. diff --git a/networkconnectivity/v1alpha1/networkconnectivity-api.json b/networkconnectivity/v1alpha1/networkconnectivity-api.json index 37db1f175ca..1a2727a6088 100644 --- a/networkconnectivity/v1alpha1/networkconnectivity-api.json +++ b/networkconnectivity/v1alpha1/networkconnectivity-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" }, @@ -664,6 +664,188 @@ } } }, + "serviceConnectPolicies": { + "methods": { + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1alpha1/projects/{projectsId}/locations/{locationsId}/serviceConnectPolicies/{serviceConnectPoliciesId}:getIamPolicy", + "httpMethod": "GET", + "id": "networkconnectivity.projects.locations.serviceConnectPolicies.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/serviceConnectPolicies/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha1/{+resource}:getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "flatPath": "v1alpha1/projects/{projectsId}/locations/{locationsId}/serviceConnectPolicies/{serviceConnectPoliciesId}:setIamPolicy", + "httpMethod": "POST", + "id": "networkconnectivity.projects.locations.serviceConnectPolicies.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/serviceConnectPolicies/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha1/{+resource}:setIamPolicy", + "request": { + "$ref": "SetIamPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1alpha1/projects/{projectsId}/locations/{locationsId}/serviceConnectPolicies/{serviceConnectPoliciesId}:testIamPermissions", + "httpMethod": "POST", + "id": "networkconnectivity.projects.locations.serviceConnectPolicies.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/serviceConnectPolicies/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha1/{+resource}:testIamPermissions", + "request": { + "$ref": "TestIamPermissionsRequest" + }, + "response": { + "$ref": "TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, + "serviceInstances": { + "methods": { + "getIamPolicy": { + "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + "flatPath": "v1alpha1/projects/{projectsId}/locations/{locationsId}/serviceInstances/{serviceInstancesId}:getIamPolicy", + "httpMethod": "GET", + "id": "networkconnectivity.projects.locations.serviceInstances.getIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "options.requestedPolicyVersion": { + "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "format": "int32", + "location": "query", + "type": "integer" + }, + "resource": { + "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/serviceInstances/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha1/{+resource}:getIamPolicy", + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "setIamPolicy": { + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + "flatPath": "v1alpha1/projects/{projectsId}/locations/{locationsId}/serviceInstances/{serviceInstancesId}:setIamPolicy", + "httpMethod": "POST", + "id": "networkconnectivity.projects.locations.serviceInstances.setIamPolicy", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/serviceInstances/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha1/{+resource}:setIamPolicy", + "request": { + "$ref": "SetIamPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "testIamPermissions": { + "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + "flatPath": "v1alpha1/projects/{projectsId}/locations/{locationsId}/serviceInstances/{serviceInstancesId}:testIamPermissions", + "httpMethod": "POST", + "id": "networkconnectivity.projects.locations.serviceInstances.testIamPermissions", + "parameterOrder": [ + "resource" + ], + "parameters": { + "resource": { + "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/serviceInstances/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1alpha1/{+resource}:testIamPermissions", + "request": { + "$ref": "TestIamPermissionsRequest" + }, + "response": { + "$ref": "TestIamPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "spokes": { "methods": { "create": { @@ -938,7 +1120,7 @@ } } }, - "revision": "20220321", + "revision": "20220404", "rootUrl": "https://networkconnectivity.googleapis.com/", "schemas": { "AuditConfig": { @@ -998,7 +1180,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" }, @@ -1389,7 +1571,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\"`", @@ -1483,7 +1665,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/networkconnectivity/v1alpha1/networkconnectivity-gen.go b/networkconnectivity/v1alpha1/networkconnectivity-gen.go index a61f75146b2..1fa45fd1910 100644 --- a/networkconnectivity/v1alpha1/networkconnectivity-gen.go +++ b/networkconnectivity/v1alpha1/networkconnectivity-gen.go @@ -154,6 +154,8 @@ func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs.Global = NewProjectsLocationsGlobalService(s) rs.InternalRanges = NewProjectsLocationsInternalRangesService(s) rs.Operations = NewProjectsLocationsOperationsService(s) + rs.ServiceConnectPolicies = NewProjectsLocationsServiceConnectPoliciesService(s) + rs.ServiceInstances = NewProjectsLocationsServiceInstancesService(s) rs.Spokes = NewProjectsLocationsSpokesService(s) return rs } @@ -167,6 +169,10 @@ type ProjectsLocationsService struct { Operations *ProjectsLocationsOperationsService + ServiceConnectPolicies *ProjectsLocationsServiceConnectPoliciesService + + ServiceInstances *ProjectsLocationsServiceInstancesService + Spokes *ProjectsLocationsSpokesService } @@ -209,6 +215,24 @@ type ProjectsLocationsOperationsService struct { s *Service } +func NewProjectsLocationsServiceConnectPoliciesService(s *Service) *ProjectsLocationsServiceConnectPoliciesService { + rs := &ProjectsLocationsServiceConnectPoliciesService{s: s} + return rs +} + +type ProjectsLocationsServiceConnectPoliciesService struct { + s *Service +} + +func NewProjectsLocationsServiceInstancesService(s *Service) *ProjectsLocationsServiceInstancesService { + rs := &ProjectsLocationsServiceInstancesService{s: s} + return rs +} + +type ProjectsLocationsServiceInstancesService struct { + s *Service +} + func NewProjectsLocationsSpokesService(s *Service) *ProjectsLocationsSpokesService { rs := &ProjectsLocationsSpokesService{s: s} return rs @@ -327,8 +351,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 @@ -1041,7 +1065,7 @@ func (s *RouterApplianceInstance) 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"` @@ -1154,7 +1178,7 @@ func (s *Spoke) 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"` @@ -1386,8 +1410,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 @@ -1516,7 +1540,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" // }, @@ -4032,6 +4056,944 @@ func (c *ProjectsLocationsOperationsListCall) Pages(ctx context.Context, f func( } } +// method id "networkconnectivity.projects.locations.serviceConnectPolicies.getIamPolicy": + +type ProjectsLocationsServiceConnectPoliciesGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. +// +// - resource: REQUIRED: The resource for which the policy is being +// requested. See the operation documentation for the appropriate +// value for this field. +func (r *ProjectsLocationsServiceConnectPoliciesService) GetIamPolicy(resource string) *ProjectsLocationsServiceConnectPoliciesGetIamPolicyCall { + c := &ProjectsLocationsServiceConnectPoliciesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + return c +} + +// OptionsRequestedPolicyVersion sets the optional parameter +// "options.requestedPolicyVersion": The maximum policy version that +// will be used to format the policy. Valid values are 0, 1, and 3. +// Requests specifying an invalid value will be rejected. Requests for +// policies with any conditional role bindings must specify version 3. +// Policies with no conditional role bindings may specify any valid +// value or leave the field unset. The policy in the response might use +// the policy version that you specified, or it might use a lower policy +// version. For example, if you specify version 3, but the policy has no +// conditional role bindings, the response uses version 1. To learn +// which resources support conditions in their IAM policies, see the IAM +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +func (c *ProjectsLocationsServiceConnectPoliciesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsServiceConnectPoliciesGetIamPolicyCall { + c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsServiceConnectPoliciesGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsServiceConnectPoliciesGetIamPolicyCall { + 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 *ProjectsLocationsServiceConnectPoliciesGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsServiceConnectPoliciesGetIamPolicyCall { + 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 *ProjectsLocationsServiceConnectPoliciesGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsServiceConnectPoliciesGetIamPolicyCall { + 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 *ProjectsLocationsServiceConnectPoliciesGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsServiceConnectPoliciesGetIamPolicyCall) 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, "v1alpha1/{+resource}:getIamPolicy") + 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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "networkconnectivity.projects.locations.serviceConnectPolicies.getIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *ProjectsLocationsServiceConnectPoliciesGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &Policy{ + 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 access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1alpha1/projects/{projectsId}/locations/{locationsId}/serviceConnectPolicies/{serviceConnectPoliciesId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "networkconnectivity.projects.locations.serviceConnectPolicies.getIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "options.requestedPolicyVersion": { + // "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/serviceConnectPolicies/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha1/{+resource}:getIamPolicy", + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "networkconnectivity.projects.locations.serviceConnectPolicies.setIamPolicy": + +type ProjectsLocationsServiceConnectPoliciesSetIamPolicyCall struct { + s *Service + resource string + setiampolicyrequest *SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy. Can return `NOT_FOUND`, +// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. +// +// - resource: REQUIRED: The resource for which the policy is being +// specified. See the operation documentation for the appropriate +// value for this field. +func (r *ProjectsLocationsServiceConnectPoliciesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsServiceConnectPoliciesSetIamPolicyCall { + c := &ProjectsLocationsServiceConnectPoliciesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.setiampolicyrequest = setiampolicyrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsServiceConnectPoliciesSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsServiceConnectPoliciesSetIamPolicyCall { + 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 *ProjectsLocationsServiceConnectPoliciesSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsServiceConnectPoliciesSetIamPolicyCall { + 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 *ProjectsLocationsServiceConnectPoliciesSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsServiceConnectPoliciesSetIamPolicyCall) 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.setiampolicyrequest) + 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, "v1alpha1/{+resource}:setIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "networkconnectivity.projects.locations.serviceConnectPolicies.setIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *ProjectsLocationsServiceConnectPoliciesSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &Policy{ + 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": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + // "flatPath": "v1alpha1/projects/{projectsId}/locations/{locationsId}/serviceConnectPolicies/{serviceConnectPoliciesId}:setIamPolicy", + // "httpMethod": "POST", + // "id": "networkconnectivity.projects.locations.serviceConnectPolicies.setIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/serviceConnectPolicies/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha1/{+resource}:setIamPolicy", + // "request": { + // "$ref": "SetIamPolicyRequest" + // }, + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "networkconnectivity.projects.locations.serviceConnectPolicies.testIamPermissions": + +type ProjectsLocationsServiceConnectPoliciesTestIamPermissionsCall struct { + s *Service + resource string + testiampermissionsrequest *TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a `NOT_FOUND` error. Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See the operation documentation for the +// appropriate value for this field. +func (r *ProjectsLocationsServiceConnectPoliciesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsServiceConnectPoliciesTestIamPermissionsCall { + c := &ProjectsLocationsServiceConnectPoliciesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.testiampermissionsrequest = testiampermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsServiceConnectPoliciesTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsServiceConnectPoliciesTestIamPermissionsCall { + 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 *ProjectsLocationsServiceConnectPoliciesTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsServiceConnectPoliciesTestIamPermissionsCall { + 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 *ProjectsLocationsServiceConnectPoliciesTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsServiceConnectPoliciesTestIamPermissionsCall) 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.testiampermissionsrequest) + 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, "v1alpha1/{+resource}:testIamPermissions") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "networkconnectivity.projects.locations.serviceConnectPolicies.testIamPermissions" call. +// Exactly one of *TestIamPermissionsResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *TestIamPermissionsResponse.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *ProjectsLocationsServiceConnectPoliciesTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &TestIamPermissionsResponse{ + 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": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1alpha1/projects/{projectsId}/locations/{locationsId}/serviceConnectPolicies/{serviceConnectPoliciesId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "networkconnectivity.projects.locations.serviceConnectPolicies.testIamPermissions", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/serviceConnectPolicies/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "TestIamPermissionsRequest" + // }, + // "response": { + // "$ref": "TestIamPermissionsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "networkconnectivity.projects.locations.serviceInstances.getIamPolicy": + +type ProjectsLocationsServiceInstancesGetIamPolicyCall struct { + s *Service + resource string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// GetIamPolicy: Gets the access control policy for a resource. Returns +// an empty policy if the resource exists and does not have a policy +// set. +// +// - resource: REQUIRED: The resource for which the policy is being +// requested. See the operation documentation for the appropriate +// value for this field. +func (r *ProjectsLocationsServiceInstancesService) GetIamPolicy(resource string) *ProjectsLocationsServiceInstancesGetIamPolicyCall { + c := &ProjectsLocationsServiceInstancesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + return c +} + +// OptionsRequestedPolicyVersion sets the optional parameter +// "options.requestedPolicyVersion": The maximum policy version that +// will be used to format the policy. Valid values are 0, 1, and 3. +// Requests specifying an invalid value will be rejected. Requests for +// policies with any conditional role bindings must specify version 3. +// Policies with no conditional role bindings may specify any valid +// value or leave the field unset. The policy in the response might use +// the policy version that you specified, or it might use a lower policy +// version. For example, if you specify version 3, but the policy has no +// conditional role bindings, the response uses version 1. To learn +// which resources support conditions in their IAM policies, see the IAM +// documentation +// (https://cloud.google.com/iam/help/conditions/resource-policies). +func (c *ProjectsLocationsServiceInstancesGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsLocationsServiceInstancesGetIamPolicyCall { + c.urlParams_.Set("options.requestedPolicyVersion", fmt.Sprint(optionsRequestedPolicyVersion)) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsServiceInstancesGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsServiceInstancesGetIamPolicyCall { + 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 *ProjectsLocationsServiceInstancesGetIamPolicyCall) IfNoneMatch(entityTag string) *ProjectsLocationsServiceInstancesGetIamPolicyCall { + 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 *ProjectsLocationsServiceInstancesGetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsServiceInstancesGetIamPolicyCall { + 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 *ProjectsLocationsServiceInstancesGetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsServiceInstancesGetIamPolicyCall) 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, "v1alpha1/{+resource}:getIamPolicy") + 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{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "networkconnectivity.projects.locations.serviceInstances.getIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *ProjectsLocationsServiceInstancesGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &Policy{ + 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 access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", + // "flatPath": "v1alpha1/projects/{projectsId}/locations/{locationsId}/serviceInstances/{serviceInstancesId}:getIamPolicy", + // "httpMethod": "GET", + // "id": "networkconnectivity.projects.locations.serviceInstances.getIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "options.requestedPolicyVersion": { + // "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "resource": { + // "description": "REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/serviceInstances/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha1/{+resource}:getIamPolicy", + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "networkconnectivity.projects.locations.serviceInstances.setIamPolicy": + +type ProjectsLocationsServiceInstancesSetIamPolicyCall struct { + s *Service + resource string + setiampolicyrequest *SetIamPolicyRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// SetIamPolicy: Sets the access control policy on the specified +// resource. Replaces any existing policy. Can return `NOT_FOUND`, +// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. +// +// - resource: REQUIRED: The resource for which the policy is being +// specified. See the operation documentation for the appropriate +// value for this field. +func (r *ProjectsLocationsServiceInstancesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsServiceInstancesSetIamPolicyCall { + c := &ProjectsLocationsServiceInstancesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.setiampolicyrequest = setiampolicyrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsServiceInstancesSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsLocationsServiceInstancesSetIamPolicyCall { + 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 *ProjectsLocationsServiceInstancesSetIamPolicyCall) Context(ctx context.Context) *ProjectsLocationsServiceInstancesSetIamPolicyCall { + 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 *ProjectsLocationsServiceInstancesSetIamPolicyCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsServiceInstancesSetIamPolicyCall) 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.setiampolicyrequest) + 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, "v1alpha1/{+resource}:setIamPolicy") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "networkconnectivity.projects.locations.serviceInstances.setIamPolicy" call. +// Exactly one of *Policy or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Policy.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *ProjectsLocationsServiceInstancesSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &Policy{ + 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": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", + // "flatPath": "v1alpha1/projects/{projectsId}/locations/{locationsId}/serviceInstances/{serviceInstancesId}:setIamPolicy", + // "httpMethod": "POST", + // "id": "networkconnectivity.projects.locations.serviceInstances.setIamPolicy", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/serviceInstances/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha1/{+resource}:setIamPolicy", + // "request": { + // "$ref": "SetIamPolicyRequest" + // }, + // "response": { + // "$ref": "Policy" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + +// method id "networkconnectivity.projects.locations.serviceInstances.testIamPermissions": + +type ProjectsLocationsServiceInstancesTestIamPermissionsCall struct { + s *Service + resource string + testiampermissionsrequest *TestIamPermissionsRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// TestIamPermissions: Returns permissions that a caller has on the +// specified resource. If the resource does not exist, this will return +// an empty set of permissions, not a `NOT_FOUND` error. Note: This +// operation is designed to be used for building permission-aware UIs +// and command-line tools, not for authorization checking. This +// operation may "fail open" without warning. +// +// - resource: REQUIRED: The resource for which the policy detail is +// being requested. See the operation documentation for the +// appropriate value for this field. +func (r *ProjectsLocationsServiceInstancesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsServiceInstancesTestIamPermissionsCall { + c := &ProjectsLocationsServiceInstancesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.resource = resource + c.testiampermissionsrequest = testiampermissionsrequest + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *ProjectsLocationsServiceInstancesTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsLocationsServiceInstancesTestIamPermissionsCall { + 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 *ProjectsLocationsServiceInstancesTestIamPermissionsCall) Context(ctx context.Context) *ProjectsLocationsServiceInstancesTestIamPermissionsCall { + 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 *ProjectsLocationsServiceInstancesTestIamPermissionsCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsServiceInstancesTestIamPermissionsCall) 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.testiampermissionsrequest) + 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, "v1alpha1/{+resource}:testIamPermissions") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "resource": c.resource, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "networkconnectivity.projects.locations.serviceInstances.testIamPermissions" call. +// Exactly one of *TestIamPermissionsResponse or error will be non-nil. +// Any non-2xx status code is an error. Response headers are in either +// *TestIamPermissionsResponse.ServerResponse.Header or (if a response +// was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *ProjectsLocationsServiceInstancesTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &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 := &TestIamPermissionsResponse{ + 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": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", + // "flatPath": "v1alpha1/projects/{projectsId}/locations/{locationsId}/serviceInstances/{serviceInstancesId}:testIamPermissions", + // "httpMethod": "POST", + // "id": "networkconnectivity.projects.locations.serviceInstances.testIamPermissions", + // "parameterOrder": [ + // "resource" + // ], + // "parameters": { + // "resource": { + // "description": "REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/serviceInstances/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1alpha1/{+resource}:testIamPermissions", + // "request": { + // "$ref": "TestIamPermissionsRequest" + // }, + // "response": { + // "$ref": "TestIamPermissionsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "networkconnectivity.projects.locations.spokes.create": type ProjectsLocationsSpokesCreateCall struct { diff --git a/networkservices/v1/networkservices-api.json b/networkservices/v1/networkservices-api.json index 20df1a220b8..7cb254b6638 100644 --- a/networkservices/v1/networkservices-api.json +++ b/networkservices/v1/networkservices-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" }, @@ -822,7 +822,7 @@ } } }, - "revision": "20211109", + "revision": "20220404", "rootUrl": "https://networkservices.googleapis.com/", "schemas": { "AuditConfig": { @@ -882,7 +882,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" }, @@ -902,7 +902,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" @@ -1256,7 +1256,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\"`", @@ -1298,7 +1298,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/networkservices/v1/networkservices-gen.go b/networkservices/v1/networkservices-gen.go index a331bb16eae..e3b37e742ad 100644 --- a/networkservices/v1/networkservices-gen.go +++ b/networkservices/v1/networkservices-gen.go @@ -327,8 +327,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 @@ -397,8 +397,7 @@ type CancelOperationRequest struct { // 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. @@ -1078,7 +1077,7 @@ func (s *Policy) 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"` @@ -1159,7 +1158,7 @@ func (s *Status) 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"` @@ -1422,8 +1421,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 @@ -1552,7 +1551,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/privateca/v1beta1/privateca-api.json b/privateca/v1beta1/privateca-api.json index 0828ef9abe7..007134f15c6 100644 --- a/privateca/v1beta1/privateca-api.json +++ b/privateca/v1beta1/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" }, @@ -1254,7 +1254,7 @@ } } }, - "revision": "20220323", + "revision": "20220406", "rootUrl": "https://privateca.googleapis.com/", "schemas": { "AccessUrls": { @@ -1404,7 +1404,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" }, @@ -2647,7 +2647,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\"`", @@ -2852,7 +2852,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/v1beta1/privateca-gen.go b/privateca/v1beta1/privateca-gen.go index 953c7749230..6acefb189df 100644 --- a/privateca/v1beta1/privateca-gen.go +++ b/privateca/v1beta1/privateca-gen.go @@ -509,8 +509,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 @@ -2627,7 +2627,7 @@ func (s *ScheduleDeleteCertificateAuthorityRequest) 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"` @@ -2957,7 +2957,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"` @@ -3227,8 +3227,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 @@ -3357,7 +3357,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/runtimeconfig/v1beta1/runtimeconfig-api.json b/runtimeconfig/v1beta1/runtimeconfig-api.json index 1ece8c32a25..7d863b305b2 100644 --- a/runtimeconfig/v1beta1/runtimeconfig-api.json +++ b/runtimeconfig/v1beta1/runtimeconfig-api.json @@ -805,7 +805,7 @@ } } }, - "revision": "20220321", + "revision": "20220404", "rootUrl": "https://runtimeconfig.googleapis.com/", "schemas": { "Binding": { @@ -817,7 +817,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" }, @@ -1020,7 +1020,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." } }, "type": "object" @@ -1057,7 +1057,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/runtimeconfig/v1beta1/runtimeconfig-gen.go b/runtimeconfig/v1beta1/runtimeconfig-gen.go index 67f8259d85a..0eaecd98730 100644 --- a/runtimeconfig/v1beta1/runtimeconfig-gen.go +++ b/runtimeconfig/v1beta1/runtimeconfig-gen.go @@ -214,8 +214,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 @@ -760,7 +760,7 @@ func (s *RuntimeConfig) 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"` @@ -835,7 +835,7 @@ func (s *Status) 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"` diff --git a/servicenetworking/v1/servicenetworking-api.json b/servicenetworking/v1/servicenetworking-api.json index dd689c962cf..6b50143aa52 100644 --- a/servicenetworking/v1/servicenetworking-api.json +++ b/servicenetworking/v1/servicenetworking-api.json @@ -860,7 +860,7 @@ } } }, - "revision": "20220321", + "revision": "20220406", "rootUrl": "https://servicenetworking.googleapis.com/", "schemas": { "AddDnsRecordSetMetadata": { @@ -1116,7 +1116,7 @@ "type": "string" }, "jwtLocations": { - "description": "Defines the locations to extract the JWT. JWT locations can be either from HTTP headers or URL query parameters. The rule is that the first match wins. The checking order is: checking all headers first, then URL query parameters. If not specified, default to use following 3 locations: 1) Authorization: Bearer 2) x-goog-iap-jwt-assertion 3) access_token query parameter Default locations can be specified as followings: jwt_locations: - header: Authorization value_prefix: \"Bearer \" - header: x-goog-iap-jwt-assertion - query: access_token", + "description": "Defines the locations to extract the JWT. For now it is only used by the Cloud Endpoints to store the OpenAPI extension [x-google-jwt-locations] (https://cloud.google.com/endpoints/docs/openapi/openapi-extensions#x-google-jwt-locations) JWT locations can be one of HTTP headers, URL query parameters or cookies. The rule is that the first match wins. If not specified, default to use following 3 locations: 1) Authorization: Bearer 2) x-goog-iap-jwt-assertion 3) access_token query parameter Default locations can be specified as followings: jwt_locations: - header: Authorization value_prefix: \"Bearer \" - header: x-goog-iap-jwt-assertion - query: access_token", "items": { "$ref": "JwtLocation" }, @@ -1986,6 +1986,10 @@ "description": "Specifies a location to extract JWT from an API request.", "id": "JwtLocation", "properties": { + "cookie": { + "description": "Specifies cookie name to extract JWT token.", + "type": "string" + }, "header": { "description": "Specifies HTTP header name to extract JWT token.", "type": "string" diff --git a/servicenetworking/v1/servicenetworking-gen.go b/servicenetworking/v1/servicenetworking-gen.go index 3611353461d..9989de93fd3 100644 --- a/servicenetworking/v1/servicenetworking-gen.go +++ b/servicenetworking/v1/servicenetworking-gen.go @@ -696,11 +696,13 @@ type AuthProvider struct { // https://www.googleapis.com/oauth2/v1/certs JwksUri string `json:"jwksUri,omitempty"` - // JwtLocations: Defines the locations to extract the JWT. JWT locations - // can be either from HTTP headers or URL query parameters. The rule is - // that the first match wins. The checking order is: checking all - // headers first, then URL query parameters. If not specified, default - // to use following 3 locations: 1) Authorization: Bearer 2) + // JwtLocations: Defines the locations to extract the JWT. For now it is + // only used by the Cloud Endpoints to store the OpenAPI extension + // [x-google-jwt-locations] + // (https://cloud.google.com/endpoints/docs/openapi/openapi-extensions#x-google-jwt-locations) + // JWT locations can be one of HTTP headers, URL query parameters or + // cookies. The rule is that the first match wins. If not specified, + // default to use following 3 locations: 1) Authorization: Bearer 2) // x-goog-iap-jwt-assertion 3) access_token query parameter Default // locations can be specified as followings: jwt_locations: - header: // Authorization value_prefix: "Bearer " - header: @@ -2455,6 +2457,9 @@ func (s *HttpRule) MarshalJSON() ([]byte, error) { // JwtLocation: Specifies a location to extract JWT from an API request. type JwtLocation struct { + // Cookie: Specifies cookie name to extract JWT token. + Cookie string `json:"cookie,omitempty"` + // Header: Specifies HTTP header name to extract JWT token. Header string `json:"header,omitempty"` @@ -2470,7 +2475,7 @@ type JwtLocation struct { // value_prefix="Bearer " with a space at the end. ValuePrefix string `json:"valuePrefix,omitempty"` - // ForceSendFields is a list of field names (e.g. "Header") to + // ForceSendFields is a list of field names (e.g. "Cookie") 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 @@ -2478,7 +2483,7 @@ type JwtLocation struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Header") to include in API + // NullFields is a list of field names (e.g. "Cookie") 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 diff --git a/vmmigration/v1/vmmigration-api.json b/vmmigration/v1/vmmigration-api.json index 05e1992e556..381f84b0ed4 100644 --- a/vmmigration/v1/vmmigration-api.json +++ b/vmmigration/v1/vmmigration-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" }, @@ -1886,7 +1886,7 @@ } } }, - "revision": "20220327", + "revision": "20220401", "rootUrl": "https://vmmigration.googleapis.com/", "schemas": { "AddGroupMigrationRequest": { diff --git a/vmmigration/v1/vmmigration-gen.go b/vmmigration/v1/vmmigration-gen.go index 6180e554b1a..6fa554fa47c 100644 --- a/vmmigration/v1/vmmigration-gen.go +++ b/vmmigration/v1/vmmigration-gen.go @@ -2815,8 +2815,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 @@ -2945,7 +2945,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/vmmigration/v1alpha1/vmmigration-api.json b/vmmigration/v1alpha1/vmmigration-api.json index 1c9346208ec..430dac77067 100644 --- a/vmmigration/v1alpha1/vmmigration-api.json +++ b/vmmigration/v1alpha1/vmmigration-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" }, @@ -1886,7 +1886,7 @@ } } }, - "revision": "20220327", + "revision": "20220401", "rootUrl": "https://vmmigration.googleapis.com/", "schemas": { "AddGroupMigrationRequest": { diff --git a/vmmigration/v1alpha1/vmmigration-gen.go b/vmmigration/v1alpha1/vmmigration-gen.go index 27fefa328e7..181777801ca 100644 --- a/vmmigration/v1alpha1/vmmigration-gen.go +++ b/vmmigration/v1alpha1/vmmigration-gen.go @@ -3093,8 +3093,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 @@ -3223,7 +3223,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/youtube/v3/youtube-api.json b/youtube/v3/youtube-api.json index 16cea4b66d0..9dfcba3feb6 100644 --- a/youtube/v3/youtube-api.json +++ b/youtube/v3/youtube-api.json @@ -3789,7 +3789,7 @@ } } }, - "revision": "20220405", + "revision": "20220409", "rootUrl": "https://youtube.googleapis.com/", "schemas": { "AbuseReport": { @@ -6728,6 +6728,7 @@ "mibacUnspecified", "mibacT", "mibacVap", + "mibacVm6", "mibacVm12", "mibacVm14", "mibacVm16", @@ -6742,6 +6743,7 @@ "", "", "", + "", "" ], "type": "string" diff --git a/youtube/v3/youtube-gen.go b/youtube/v3/youtube-gen.go index 4046dc670ee..1a38866f9dd 100644 --- a/youtube/v3/youtube-gen.go +++ b/youtube/v3/youtube-gen.go @@ -3753,6 +3753,7 @@ type ContentRating struct { // "mibacUnspecified" // "mibacT" // "mibacVap" + // "mibacVm6" // "mibacVm12" // "mibacVm14" // "mibacVm16" From 6944086dff5111497e28d1e07e9d357533546e65 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Wed, 13 Apr 2022 07:24:41 -0700 Subject: [PATCH 10/17] feat(all): auto-regenerate discovery clients (#1510) --- .../v1/androidmanagement-api.json | 71 +- androidmanagement/v1/androidmanagement-gen.go | 121 ++- androidpublisher/v3/androidpublisher-api.json | 12 +- androidpublisher/v3/androidpublisher-gen.go | 22 +- api-list.json | 19 +- apigee/v1/apigee-api.json | 17 +- apigee/v1/apigee-gen.go | 15 +- civicinfo/v2/civicinfo-api.json | 98 +- civicinfo/v2/civicinfo-gen.go | 92 +- cloudasset/v1/cloudasset-api.json | 27 +- cloudasset/v1/cloudasset-gen.go | 39 +- cloudasset/v1beta1/cloudasset-api.json | 4 +- cloudasset/v1beta1/cloudasset-gen.go | 4 +- cloudasset/v1p1beta1/cloudasset-api.json | 4 +- cloudasset/v1p1beta1/cloudasset-gen.go | 4 +- cloudasset/v1p4beta1/cloudasset-api.json | 4 +- cloudasset/v1p4beta1/cloudasset-gen.go | 4 +- cloudasset/v1p5beta1/cloudasset-api.json | 4 +- cloudasset/v1p5beta1/cloudasset-gen.go | 4 +- cloudasset/v1p7beta1/cloudasset-api.json | 4 +- cloudasset/v1p7beta1/cloudasset-gen.go | 4 +- dataproc/v1/dataproc-api.json | 235 ++++- dataproc/v1/dataproc-gen.go | 467 ++++++++- displayvideo/v1/displayvideo-api.json | 32 +- displayvideo/v1/displayvideo-gen.go | 39 +- documentai/v1/documentai-api.json | 33 +- documentai/v1/documentai-gen.go | 69 ++ documentai/v1beta2/documentai-api.json | 13 +- documentai/v1beta2/documentai-gen.go | 30 + documentai/v1beta3/documentai-api.json | 33 +- documentai/v1beta3/documentai-gen.go | 69 ++ .../v1beta/firebaseappcheck-api.json | 220 +--- .../v1beta/firebaseappcheck-gen.go | 964 +----------------- gkebackup/v1/gkebackup-api.json | 10 +- gkebackup/v1/gkebackup-gen.go | 14 +- iap/v1/iap-api.json | 8 +- iap/v1/iap-gen.go | 8 +- iap/v1beta1/iap-api.json | 8 +- iap/v1beta1/iap-gen.go | 8 +- ml/v1/ml-api.json | 8 +- ml/v1/ml-gen.go | 8 +- .../v1beta1/recommendationengine-api.json | 10 +- .../v1beta1/recommendationengine-gen.go | 19 +- run/v1/run-api.json | 12 +- run/v1/run-gen.go | 17 +- secretmanager/v1/secretmanager-api.json | 14 +- secretmanager/v1/secretmanager-gen.go | 20 +- secretmanager/v1beta1/secretmanager-api.json | 10 +- secretmanager/v1beta1/secretmanager-gen.go | 14 +- securitycenter/v1/securitycenter-api.json | 20 +- securitycenter/v1/securitycenter-gen.go | 10 +- .../v1beta1/securitycenter-api.json | 20 +- securitycenter/v1beta1/securitycenter-gen.go | 10 +- .../v1beta2/securitycenter-api.json | 14 +- securitycenter/v1beta2/securitycenter-gen.go | 2 + slides/v1/slides-api.json | 10 +- slides/v1/slides-gen.go | 13 +- 57 files changed, 1591 insertions(+), 1473 deletions(-) diff --git a/androidmanagement/v1/androidmanagement-api.json b/androidmanagement/v1/androidmanagement-api.json index fe6406d00e8..75c2c615b55 100644 --- a/androidmanagement/v1/androidmanagement-api.json +++ b/androidmanagement/v1/androidmanagement-api.json @@ -115,12 +115,12 @@ "parameterOrder": [], "parameters": { "agreementAccepted": { - "description": "Whether the enterprise admin has seen and agreed to the managed Google Play Agreement (https://www.android.com/enterprise/terms/). Always set this to true when creating an EMM-managed enterprise. Do not create the enterprise until the admin has viewed and accepted the agreement.", + "description": "Whether the enterprise admin has seen and agreed to the managed Google Play Agreement (https://www.android.com/enterprise/terms/). Do not set this field for any customer-managed enterprise (https://developers.google.com/android/management/create-enterprise#customer-managed_enterprises). Set this to field to true for all EMM-managed enterprises (https://developers.google.com/android/management/create-enterprise#emm-managed_enterprises).", "location": "query", "type": "boolean" }, "enterpriseToken": { - "description": "The enterprise token appended to the callback URL. Only set this when creating a customer-managed enterprise.", + "description": "The enterprise token appended to the callback URL. Set this when creating a customer-managed enterprise (https://developers.google.com/android/management/create-enterprise#customer-managed_enterprises) and not when creating a deprecated EMM-managed enterprise (https://developers.google.com/android/management/create-enterprise#emm-managed_enterprises).", "location": "query", "type": "string" }, @@ -130,7 +130,7 @@ "type": "string" }, "signupUrlName": { - "description": "The name of the SignupUrl used to sign up for the enterprise. Only set this when creating a customer-managed enterprise.", + "description": "The name of the SignupUrl used to sign up for the enterprise. Set this when creating a customer-managed enterprise (https://developers.google.com/android/management/create-enterprise#customer-managed_enterprises) and not when creating a deprecated EMM-managed enterprise (https://developers.google.com/android/management/create-enterprise#emm-managed_enterprises).", "location": "query", "type": "string" } @@ -1004,7 +1004,7 @@ } } }, - "revision": "20220330", + "revision": "20220404", "rootUrl": "https://androidmanagement.googleapis.com/", "schemas": { "AdvancedSecurityOverrides": { @@ -1126,11 +1126,11 @@ "id": "AppVersion", "properties": { "production": { - "description": "True if this version is a production track.", + "description": "If the value is True, it indicates that this version is a production track.", "type": "boolean" }, "trackIds": { - "description": "Track ids that the app version is published in. This doesn't include the production track (see production instead).", + "description": "Track identifiers that the app version is published in. This does not include the production track (see production instead).", "items": { "type": "string" }, @@ -1257,7 +1257,7 @@ "type": "string" }, "iconUrl": { - "description": "A link to an image that can be used as an icon for the app. This image is suitable for use at up to 512px x 512px", + "description": "A link to an image that can be used as an icon for the app. This image is suitable for use up to a pixel size of 512 x 512.", "type": "string" }, "managedProperties": { @@ -1299,7 +1299,7 @@ "type": "array" }, "smallIconUrl": { - "description": "A link to a smaller image that can be used as an icon for the app. This image is suitable for use at up to 128px x 128px.", + "description": "A link to a smaller image that can be used as an icon for the app. This image is suitable for use up to a pixel size of 128 x 128.", "type": "string" }, "title": { @@ -2354,14 +2354,16 @@ "ENROLLMENT", "COMPLIANCE_REPORT", "STATUS_REPORT", - "COMMAND" + "COMMAND", + "USAGE_LOGS" ], "enumDescriptions": [ "This value is ignored.", "A notification sent when a device enrolls.", "Deprecated.", "A notification sent when a device issues a status report.", - "A notification sent when a device command has completed." + "A notification sent when a device command has completed.", + "A notification sent when device sends BatchUsageLogEvents." ], "type": "string" }, @@ -2385,7 +2387,7 @@ "type": "integer" }, "pubsubTopic": { - "description": "The topic that Cloud Pub/Sub notifications are published to, in the form projects/{project}/topics/{topic}. This field is only required if Pub/Sub notifications are enabled.", + "description": "The topic which Pub/Sub notifications are published to, in the form projects/{project}/topics/{topic}. This field is only required if Pub/Sub notifications are enabled.", "type": "string" }, "signinDetails": { @@ -2414,7 +2416,7 @@ "type": "string" }, "signingKeyFingerprintsSha256": { - "description": "Hex-encoded SHA256 hash of the signing certificate of the extension app. Only hexadecimal string representations of 64 characters are valid.If not specified, the signature for the corresponding package name is obtained from the Play Store instead.If this list is empty, the signature of the extension app on the device must match the signature obtained from the Play Store for the app to be able to communicate with Android Device Policy.If this list is not empty, the signature of the extension app on the device must match one of the entries in this list for the app to be able to communicate with Android Device Policy.In production use cases, it is recommended to leave this empty.", + "description": "Hex-encoded SHA-256 hash of the signing certificate of the extension app. Only hexadecimal string representations of 64 characters are valid.If not specified, the signature for the corresponding package name is obtained from the Play Store instead.If this list is empty, the signature of the extension app on the device must match the signature obtained from the Play Store for the app to be able to communicate with Android Device Policy.If this list is not empty, the signature of the extension app on the device must match one of the entries in this list for the app to be able to communicate with Android Device Policy.In production use cases, it is recommended to leave this empty.", "items": { "type": "string" }, @@ -3995,6 +3997,10 @@ "description": "If microphone_access is set to any value other than MICROPHONE_ACCESS_UNSPECIFIED, this has no effect. Otherwise this field controls whether microphones are disabled: If true, all microphones are disabled, otherwise they are available. This is available only on fully managed devices.", "type": "boolean" }, + "usageLog": { + "$ref": "UsageLog", + "description": "Configuration of device activity logging." + }, "usbFileTransferDisabled": { "description": "Whether transferring files over USB is disabled.", "type": "boolean" @@ -4466,6 +4472,47 @@ }, "type": "object" }, + "UsageLog": { + "description": "Controls types of device activity logs collected from the device and reported via Pub/Sub notification (https://developers.google.com/android/management/notifications).", + "id": "UsageLog", + "properties": { + "enabledLogTypes": { + "description": "Specifies which log types are enabled. Note that users will receive on-device messaging when usage logging is enabled.", + "items": { + "enum": [ + "LOG_TYPE_UNSPECIFIED", + "SECURITY_LOGS", + "NETWORK_ACTIVITY_LOGS" + ], + "enumDescriptions": [ + "This value is not used.", + "Enable logging of on-device security events, like when the device password is incorrectly entered or removable storage is mounted. See event for a complete description of the logged security events. Supported for fully managed devices on Android 7.0 and above. Supported for company-owned devices with a work profile on Android 12 and above, on which only security events from the work profile are logged.", + "Enable logging of on-device network events, like DNS lookups and TCP connections. See event for a complete description of the logged network events. Supported for fully managed devices on Android 8 and above. Supported for company-owned devices with a work profile on Android 12 and above, on which only network events from the work profile are logged." + ], + "type": "string" + }, + "type": "array" + }, + "uploadOnCellularAllowed": { + "description": "Specifies which of the enabled log types can be uploaded over mobile data. By default logs are queued for upload when the device connects to WiFi.", + "items": { + "enum": [ + "LOG_TYPE_UNSPECIFIED", + "SECURITY_LOGS", + "NETWORK_ACTIVITY_LOGS" + ], + "enumDescriptions": [ + "This value is not used.", + "Enable logging of on-device security events, like when the device password is incorrectly entered or removable storage is mounted. See event for a complete description of the logged security events. Supported for fully managed devices on Android 7.0 and above. Supported for company-owned devices with a work profile on Android 12 and above, on which only security events from the work profile are logged.", + "Enable logging of on-device network events, like DNS lookups and TCP connections. See event for a complete description of the logged network events. Supported for fully managed devices on Android 8 and above. Supported for company-owned devices with a work profile on Android 12 and above, on which only network events from the work profile are logged." + ], + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, "User": { "description": "A user belonging to an enterprise.", "id": "User", diff --git a/androidmanagement/v1/androidmanagement-gen.go b/androidmanagement/v1/androidmanagement-gen.go index 61ba7ab1690..2aa199618cd 100644 --- a/androidmanagement/v1/androidmanagement-gen.go +++ b/androidmanagement/v1/androidmanagement-gen.go @@ -437,11 +437,12 @@ func (s *AppTrackInfo) MarshalJSON() ([]byte, error) { // AppVersion: This represents a single version of the app. type AppVersion struct { - // Production: True if this version is a production track. + // Production: If the value is True, it indicates that this version is a + // production track. Production bool `json:"production,omitempty"` - // TrackIds: Track ids that the app version is published in. This - // doesn't include the production track (see production instead). + // TrackIds: Track identifiers that the app version is published in. + // This does not include the production track (see production instead). TrackIds []string `json:"trackIds,omitempty"` // VersionCode: Unique increasing identifier for the app version. @@ -545,7 +546,7 @@ type Application struct { FullDescription string `json:"fullDescription,omitempty"` // IconUrl: A link to an image that can be used as an icon for the app. - // This image is suitable for use at up to 512px x 512px + // This image is suitable for use up to a pixel size of 512 x 512. IconUrl string `json:"iconUrl,omitempty"` // ManagedProperties: The set of managed properties available to be @@ -575,7 +576,8 @@ type Application struct { ScreenshotUrls []string `json:"screenshotUrls,omitempty"` // SmallIconUrl: A link to a smaller image that can be used as an icon - // for the app. This image is suitable for use at up to 128px x 128px. + // for the app. This image is suitable for use up to a pixel size of 128 + // x 128. SmallIconUrl string `json:"smallIconUrl,omitempty"` // Title: The title of the app. Localized. @@ -1968,6 +1970,8 @@ type Enterprise struct { // report. // "COMMAND" - A notification sent when a device command has // completed. + // "USAGE_LOGS" - A notification sent when device sends + // BatchUsageLogEvents. EnabledNotificationTypes []string `json:"enabledNotificationTypes,omitempty"` // EnterpriseDisplayName: The name of the enterprise displayed to users. @@ -1988,8 +1992,8 @@ type Enterprise struct { // where the value of each component is between 0 and 255, inclusive. PrimaryColor int64 `json:"primaryColor,omitempty"` - // PubsubTopic: The topic that Cloud Pub/Sub notifications are published - // to, in the form projects/{project}/topics/{topic}. This field is only + // PubsubTopic: The topic which Pub/Sub notifications are published to, + // in the form projects/{project}/topics/{topic}. This field is only // required if Pub/Sub notifications are enabled. PubsubTopic string `json:"pubsubTopic,omitempty"` @@ -2039,7 +2043,7 @@ type ExtensionConfig struct { // of any local command status updates. NotificationReceiver string `json:"notificationReceiver,omitempty"` - // SigningKeyFingerprintsSha256: Hex-encoded SHA256 hash of the signing + // SigningKeyFingerprintsSha256: Hex-encoded SHA-256 hash of the signing // certificate of the extension app. Only hexadecimal string // representations of 64 characters are valid.If not specified, the // signature for the corresponding package name is obtained from the @@ -4105,6 +4109,9 @@ type Policy struct { // This is available only on fully managed devices. UnmuteMicrophoneDisabled bool `json:"unmuteMicrophoneDisabled,omitempty"` + // UsageLog: Configuration of device activity logging. + UsageLog *UsageLog `json:"usageLog,omitempty"` + // UsbFileTransferDisabled: Whether transferring files over USB is // disabled. UsbFileTransferDisabled bool `json:"usbFileTransferDisabled,omitempty"` @@ -4887,6 +4894,75 @@ func (s *TermsAndConditions) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// UsageLog: Controls types of device activity logs collected from the +// device and reported via Pub/Sub notification +// (https://developers.google.com/android/management/notifications). +type UsageLog struct { + // EnabledLogTypes: Specifies which log types are enabled. Note that + // users will receive on-device messaging when usage logging is enabled. + // + // Possible values: + // "LOG_TYPE_UNSPECIFIED" - This value is not used. + // "SECURITY_LOGS" - Enable logging of on-device security events, like + // when the device password is incorrectly entered or removable storage + // is mounted. See event for a complete description of the logged + // security events. Supported for fully managed devices on Android 7.0 + // and above. Supported for company-owned devices with a work profile on + // Android 12 and above, on which only security events from the work + // profile are logged. + // "NETWORK_ACTIVITY_LOGS" - Enable logging of on-device network + // events, like DNS lookups and TCP connections. See event for a + // complete description of the logged network events. Supported for + // fully managed devices on Android 8 and above. Supported for + // company-owned devices with a work profile on Android 12 and above, on + // which only network events from the work profile are logged. + EnabledLogTypes []string `json:"enabledLogTypes,omitempty"` + + // UploadOnCellularAllowed: Specifies which of the enabled log types can + // be uploaded over mobile data. By default logs are queued for upload + // when the device connects to WiFi. + // + // Possible values: + // "LOG_TYPE_UNSPECIFIED" - This value is not used. + // "SECURITY_LOGS" - Enable logging of on-device security events, like + // when the device password is incorrectly entered or removable storage + // is mounted. See event for a complete description of the logged + // security events. Supported for fully managed devices on Android 7.0 + // and above. Supported for company-owned devices with a work profile on + // Android 12 and above, on which only security events from the work + // profile are logged. + // "NETWORK_ACTIVITY_LOGS" - Enable logging of on-device network + // events, like DNS lookups and TCP connections. See event for a + // complete description of the logged network events. Supported for + // fully managed devices on Android 8 and above. Supported for + // company-owned devices with a work profile on Android 12 and above, on + // which only network events from the work profile are logged. + UploadOnCellularAllowed []string `json:"uploadOnCellularAllowed,omitempty"` + + // ForceSendFields is a list of field names (e.g. "EnabledLogTypes") 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. "EnabledLogTypes") 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 *UsageLog) MarshalJSON() ([]byte, error) { + type NoMethod UsageLog + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // User: A user belonging to an enterprise. type User struct { // AccountIdentifier: A unique identifier you create for this user, such @@ -5191,18 +5267,22 @@ func (r *EnterprisesService) Create(enterprise *Enterprise) *EnterprisesCreateCa // AgreementAccepted sets the optional parameter "agreementAccepted": // Whether the enterprise admin has seen and agreed to the managed -// Google Play Agreement (https://www.android.com/enterprise/terms/). -// Always set this to true when creating an EMM-managed enterprise. Do -// not create the enterprise until the admin has viewed and accepted the -// agreement. +// Google Play Agreement (https://www.android.com/enterprise/terms/). Do +// not set this field for any customer-managed enterprise +// (https://developers.google.com/android/management/create-enterprise#customer-managed_enterprises). +// Set this to field to true for all EMM-managed enterprises +// (https://developers.google.com/android/management/create-enterprise#emm-managed_enterprises). func (c *EnterprisesCreateCall) AgreementAccepted(agreementAccepted bool) *EnterprisesCreateCall { c.urlParams_.Set("agreementAccepted", fmt.Sprint(agreementAccepted)) return c } // EnterpriseToken sets the optional parameter "enterpriseToken": The -// enterprise token appended to the callback URL. Only set this when -// creating a customer-managed enterprise. +// enterprise token appended to the callback URL. Set this when creating +// a customer-managed enterprise +// (https://developers.google.com/android/management/create-enterprise#customer-managed_enterprises) +// and not when creating a deprecated EMM-managed enterprise +// (https://developers.google.com/android/management/create-enterprise#emm-managed_enterprises). func (c *EnterprisesCreateCall) EnterpriseToken(enterpriseToken string) *EnterprisesCreateCall { c.urlParams_.Set("enterpriseToken", enterpriseToken) return c @@ -5216,8 +5296,11 @@ func (c *EnterprisesCreateCall) ProjectId(projectId string) *EnterprisesCreateCa } // SignupUrlName sets the optional parameter "signupUrlName": The name -// of the SignupUrl used to sign up for the enterprise. Only set this -// when creating a customer-managed enterprise. +// of the SignupUrl used to sign up for the enterprise. Set this when +// creating a customer-managed enterprise +// (https://developers.google.com/android/management/create-enterprise#customer-managed_enterprises) +// and not when creating a deprecated EMM-managed enterprise +// (https://developers.google.com/android/management/create-enterprise#emm-managed_enterprises). func (c *EnterprisesCreateCall) SignupUrlName(signupUrlName string) *EnterprisesCreateCall { c.urlParams_.Set("signupUrlName", signupUrlName) return c @@ -5318,12 +5401,12 @@ func (c *EnterprisesCreateCall) Do(opts ...googleapi.CallOption) (*Enterprise, e // "parameterOrder": [], // "parameters": { // "agreementAccepted": { - // "description": "Whether the enterprise admin has seen and agreed to the managed Google Play Agreement (https://www.android.com/enterprise/terms/). Always set this to true when creating an EMM-managed enterprise. Do not create the enterprise until the admin has viewed and accepted the agreement.", + // "description": "Whether the enterprise admin has seen and agreed to the managed Google Play Agreement (https://www.android.com/enterprise/terms/). Do not set this field for any customer-managed enterprise (https://developers.google.com/android/management/create-enterprise#customer-managed_enterprises). Set this to field to true for all EMM-managed enterprises (https://developers.google.com/android/management/create-enterprise#emm-managed_enterprises).", // "location": "query", // "type": "boolean" // }, // "enterpriseToken": { - // "description": "The enterprise token appended to the callback URL. Only set this when creating a customer-managed enterprise.", + // "description": "The enterprise token appended to the callback URL. Set this when creating a customer-managed enterprise (https://developers.google.com/android/management/create-enterprise#customer-managed_enterprises) and not when creating a deprecated EMM-managed enterprise (https://developers.google.com/android/management/create-enterprise#emm-managed_enterprises).", // "location": "query", // "type": "string" // }, @@ -5333,7 +5416,7 @@ func (c *EnterprisesCreateCall) Do(opts ...googleapi.CallOption) (*Enterprise, e // "type": "string" // }, // "signupUrlName": { - // "description": "The name of the SignupUrl used to sign up for the enterprise. Only set this when creating a customer-managed enterprise.", + // "description": "The name of the SignupUrl used to sign up for the enterprise. Set this when creating a customer-managed enterprise (https://developers.google.com/android/management/create-enterprise#customer-managed_enterprises) and not when creating a deprecated EMM-managed enterprise (https://developers.google.com/android/management/create-enterprise#emm-managed_enterprises).", // "location": "query", // "type": "string" // } diff --git a/androidpublisher/v3/androidpublisher-api.json b/androidpublisher/v3/androidpublisher-api.json index 78fcdeb325e..d825b7ce88b 100644 --- a/androidpublisher/v3/androidpublisher-api.json +++ b/androidpublisher/v3/androidpublisher-api.json @@ -1975,7 +1975,7 @@ ], "parameters": { "name": { - "description": "Required. Resource name for this grant, following the pattern \"developers/{developer}/users/{email}/grants/{package_name}\".", + "description": "Required. Resource name for this grant, following the pattern \"developers/{developer}/users/{email}/grants/{package_name}\". If this grant is for a draft app, the app ID will be used in this resource name instead of the package name.", "location": "path", "pattern": "^developers/[^/]+/users/[^/]+/grants/[^/]+$", "required": true, @@ -3147,7 +3147,7 @@ } } }, - "revision": "20220329", + "revision": "20220411", "rootUrl": "https://androidpublisher.googleapis.com/", "schemas": { "Apk": { @@ -3944,11 +3944,11 @@ "type": "array" }, "name": { - "description": "Required. Resource name for this grant, following the pattern \"developers/{developer}/users/{email}/grants/{package_name}\".", + "description": "Required. Resource name for this grant, following the pattern \"developers/{developer}/users/{email}/grants/{package_name}\". If this grant is for a draft app, the app ID will be used in this resource name instead of the package name.", "type": "string" }, "packageName": { - "description": "Immutable. The package name of the app.", + "description": "Immutable. The package name of the app. This will be empty for draft apps.", "type": "string" } }, @@ -5077,7 +5077,7 @@ "type": "string" }, "expirationTime": { - "description": "The time at which the user's access expires, if set.", + "description": "The time at which the user's access expires, if set. When setting this value, it must always be in the future.", "format": "google-datetime", "type": "string" }, @@ -5094,7 +5094,7 @@ "type": "string" }, "partial": { - "description": "Output only. Whether there are more permissions for the user that are not represented here.", + "description": "Output only. Whether there are more permissions for the user that are not represented here. This can happen if the caller does not have permission to manage all apps in the account. This is also `true` if this user is the account owner. If this field is `true`, it should be taken as a signal that this user cannot be fully managed via the API. That is, the API caller is not be able to manage all of the permissions this user holds, either because it doesn't know about them or because the user is the account owner.", "readOnly": true, "type": "boolean" } diff --git a/androidpublisher/v3/androidpublisher-gen.go b/androidpublisher/v3/androidpublisher-gen.go index 7eb67986518..3b47a305eda 100644 --- a/androidpublisher/v3/androidpublisher-gen.go +++ b/androidpublisher/v3/androidpublisher-gen.go @@ -1843,10 +1843,13 @@ type Grant struct { AppLevelPermissions []string `json:"appLevelPermissions,omitempty"` // Name: Required. Resource name for this grant, following the pattern - // "developers/{developer}/users/{email}/grants/{package_name}". + // "developers/{developer}/users/{email}/grants/{package_name}". If this + // grant is for a draft app, the app ID will be used in this resource + // name instead of the package name. Name string `json:"name,omitempty"` - // PackageName: Immutable. The package name of the app. + // PackageName: Immutable. The package name of the app. This will be + // empty for draft apps. PackageName string `json:"packageName,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -3876,6 +3879,7 @@ type User struct { Email string `json:"email,omitempty"` // ExpirationTime: The time at which the user's access expires, if set. + // When setting this value, it must always be in the future. ExpirationTime string `json:"expirationTime,omitempty"` // Grants: Output only. Per-app permissions for the user. @@ -3886,7 +3890,13 @@ type User struct { Name string `json:"name,omitempty"` // Partial: Output only. Whether there are more permissions for the user - // that are not represented here. + // that are not represented here. This can happen if the caller does not + // have permission to manage all apps in the account. This is also + // `true` if this user is the account owner. If this field is `true`, it + // should be taken as a signal that this user cannot be fully managed + // via the API. That is, the API caller is not be able to manage all of + // the permissions this user holds, either because it doesn't know about + // them or because the user is the account owner. Partial bool `json:"partial,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -11493,7 +11503,9 @@ type GrantsPatchCall struct { // Patch: Updates access for the user to the given package. // // - name: Resource name for this grant, following the pattern -// "developers/{developer}/users/{email}/grants/{package_name}". +// "developers/{developer}/users/{email}/grants/{package_name}". If +// this grant is for a draft app, the app ID will be used in this +// resource name instead of the package name. func (r *GrantsService) Patch(name string, grant *Grant) *GrantsPatchCall { c := &GrantsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name @@ -11608,7 +11620,7 @@ func (c *GrantsPatchCall) Do(opts ...googleapi.CallOption) (*Grant, error) { // ], // "parameters": { // "name": { - // "description": "Required. Resource name for this grant, following the pattern \"developers/{developer}/users/{email}/grants/{package_name}\".", + // "description": "Required. Resource name for this grant, following the pattern \"developers/{developer}/users/{email}/grants/{package_name}\". If this grant is for a draft app, the app ID will be used in this resource name instead of the package name.", // "location": "path", // "pattern": "^developers/[^/]+/users/[^/]+/grants/[^/]+$", // "required": true, diff --git a/api-list.json b/api-list.json index 8f163d55730..3c4a14d8595 100644 --- a/api-list.json +++ b/api-list.json @@ -556,13 +556,28 @@ "documentationLink": "https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/", "preferred": true }, + { + "kind": "discovery#directoryItem", + "id": "baremetalsolution:v1alpha1", + "name": "baremetalsolution", + "version": "v1alpha1", + "title": "Bare Metal Solution API", + "description": "Provides ways to manage Bare Metal Solution hardware installed in a regional extension located near a Google Cloud data center.", + "discoveryRestUrl": "https://baremetalsolution.googleapis.com/$discovery/rest?version=v1alpha1", + "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/bare-metal", + "preferred": false + }, { "kind": "discovery#directoryItem", "id": "baremetalsolution:v1", "name": "baremetalsolution", "version": "v1", "title": "Bare Metal Solution API", - "description": "Bare Metal Solution provides hardware to run specialized workloads with low latency on Google Cloud.", + "description": "Provides ways to manage Bare Metal Solution hardware installed in a regional extension located near a Google Cloud data center.", "discoveryRestUrl": "https://baremetalsolution.googleapis.com/$discovery/rest?version=v1", "icons": { "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", @@ -577,7 +592,7 @@ "name": "baremetalsolution", "version": "v2", "title": "Bare Metal Solution API", - "description": "Bare Metal Solution provides hardware to run specialized workloads with low latency on Google Cloud.", + "description": "Provides ways to manage Bare Metal Solution hardware installed in a regional extension located near a Google Cloud data center.", "discoveryRestUrl": "https://baremetalsolution.googleapis.com/$discovery/rest?version=v2", "icons": { "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", diff --git a/apigee/v1/apigee-api.json b/apigee/v1/apigee-api.json index 3618d149e9a..ed98989bc3f 100644 --- a/apigee/v1/apigee-api.json +++ b/apigee/v1/apigee-api.json @@ -7588,7 +7588,7 @@ } } }, - "revision": "20220324", + "revision": "20220407", "rootUrl": "https://apigee.googleapis.com/", "schemas": { "EdgeConfigstoreBundleBadBundle": { @@ -10629,6 +10629,7 @@ "type": "object" }, "GoogleCloudApigeeV1ListApiProxiesResponse": { + "description": "To change this message, in the same CL add a change log in go/changing-api-proto-breaks-ui", "id": "GoogleCloudApigeeV1ListApiProxiesResponse", "properties": { "proxies": { @@ -10984,6 +10985,7 @@ "type": "object" }, "GoogleCloudApigeeV1ListSharedFlowsResponse": { + "description": "To change this message, in the same CL add a change log in go/changing-api-proto-breaks-ui", "id": "GoogleCloudApigeeV1ListSharedFlowsResponse", "properties": { "sharedFlows": { @@ -11204,6 +11206,13 @@ "targetResourceName": { "description": "Name of the resource for which the operation is operating on.", "type": "string" + }, + "warnings": { + "description": "Warnings encountered while executing the operation.", + "items": { + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -13044,7 +13053,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" }, @@ -13094,7 +13103,7 @@ "properties": { "policy": { "$ref": "GoogleIamV1Policy", - "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\"`", @@ -13109,7 +13118,7 @@ "id": "GoogleIamV1TestIamPermissionsRequest", "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/apigee/v1/apigee-gen.go b/apigee/v1/apigee-gen.go index eac1a1f8c99..dbf201f6d24 100644 --- a/apigee/v1/apigee-gen.go +++ b/apigee/v1/apigee-gen.go @@ -5493,6 +5493,8 @@ func (s *GoogleCloudApigeeV1ListApiProductsResponse) MarshalJSON() ([]byte, erro return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudApigeeV1ListApiProxiesResponse: To change this message, in +// the same CL add a change log in go/changing-api-proto-breaks-ui type GoogleCloudApigeeV1ListApiProxiesResponse struct { Proxies []*GoogleCloudApigeeV1ApiProxy `json:"proxies,omitempty"` @@ -6297,6 +6299,8 @@ func (s *GoogleCloudApigeeV1ListRatePlansResponse) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudApigeeV1ListSharedFlowsResponse: To change this message, +// in the same CL add a change log in go/changing-api-proto-breaks-ui type GoogleCloudApigeeV1ListSharedFlowsResponse struct { SharedFlows []*GoogleCloudApigeeV1SharedFlow `json:"sharedFlows,omitempty"` @@ -6661,6 +6665,9 @@ type GoogleCloudApigeeV1OperationMetadata struct { // operating on. TargetResourceName string `json:"targetResourceName,omitempty"` + // Warnings: Warnings encountered while executing the operation. + Warnings []string `json:"warnings,omitempty"` + // ForceSendFields is a list of field names (e.g. "OperationType") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -9658,8 +9665,8 @@ type GoogleIamV1Binding struct { // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *GoogleTypeExpr `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 @@ -9834,7 +9841,7 @@ func (s *GoogleIamV1Policy) MarshalJSON() ([]byte, error) { type GoogleIamV1SetIamPolicyRequest 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 *GoogleIamV1Policy `json:"policy,omitempty"` @@ -9871,7 +9878,7 @@ func (s *GoogleIamV1SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // `TestIamPermissions` method. type GoogleIamV1TestIamPermissionsRequest 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"` diff --git a/civicinfo/v2/civicinfo-api.json b/civicinfo/v2/civicinfo-api.json index 5a84838db88..2b79d850909 100644 --- a/civicinfo/v2/civicinfo-api.json +++ b/civicinfo/v2/civicinfo-api.json @@ -352,7 +352,7 @@ } } }, - "revision": "20211209", + "revision": "20220412", "rootUrl": "https://civicinfo.googleapis.com/", "schemas": { "AdministrationRegion": { @@ -946,7 +946,7 @@ "typeTransitDeparture", "typeTransitLeg", "typeTransitLine", - "typeTransitAgency", + "typeTransitAgencyDeprecatedValue", "typeTransitTransfer", "typeSegmentPath", "typeRoadSign", @@ -1202,6 +1202,8 @@ "typePhoneNumberAreaCode", "typeBusinessCorridor", "typeAddressTemplate", + "typeTransitAgency", + "typeFutureGeometry", "typeEvent", "typeEarthquake", "typeHurricane", @@ -1315,7 +1317,7 @@ "DEPRECATED", "DEPRECATED", "A transit line is a collection of transit legs, associated with some invariant properties of the trips that run over the legs. See also transitline.proto", - "A transit agency operates a number of lines, typically all in the same city, region or country. See also transitagency.proto", + "TYPE_TRANSIT_AGENCY was moved to 0xC91. This deprecated enum value still exists for debugging purposes only.", "DEPRECATED", "ABSTRACT", "Road sign features have names, point geometry, etc. They also have segment_path data (see below) which lists the segments that refer to the sign. See segment.proto for the reference from the segment to the road sign.", @@ -1571,6 +1573,8 @@ "A phone number area code is a prefix which also coincides with the area code, or national destination code, of a particular region.", "A Business Corridor is a dense cluster of semantically similar establishments. TYPE_BUSINESS_CORRIDOR features are distinguished from TYPE_COLLOQUIAL_AREA features because the corridors are not under the political hierarchy, are allowed to be nameless, and may not correspond to well-known real world locations. For more details, see go/geo-corridors-schema.", "An address template feature provides region-specific conventions for structuring addresses. These features aren't necessarily defined by physical geographic features, so they are classified as meta-features.", + "A transit agency operates a number of lines, typically all in the same city, region or country. See also transitagency.proto", + "A feature whose geometry is planned to replace the geometry on another feature.", "DEPRECATED", "DEPRECATED", "DEPRECATED", @@ -1877,6 +1881,87 @@ }, "type": "object" }, + "Precinct": { + "id": "Precinct", + "properties": { + "administrationRegionId": { + "description": "ID of the AdministrationRegion message for this precinct. Corresponds to LocalityId xml tag.", + "type": "string" + }, + "contestId": { + "description": "ID(s) of the Contest message(s) for this precinct.", + "items": { + "type": "string" + }, + "type": "array" + }, + "datasetId": { + "description": "Required. Dataset ID. What datasets our Precincts come from.", + "format": "int64", + "type": "string" + }, + "earlyVoteSiteId": { + "description": "ID(s) of the PollingLocation message(s) for this precinct.", + "items": { + "type": "string" + }, + "type": "array" + }, + "electoralDistrictId": { + "description": "ID(s) of the ElectoralDistrict message(s) for this precinct.", + "items": { + "type": "string" + }, + "type": "array" + }, + "id": { + "description": "Required. A unique identifier for this precinct.", + "type": "string" + }, + "mailOnly": { + "description": "Specifies if the precinct runs mail-only elections.", + "type": "boolean" + }, + "name": { + "description": "Required. The name of the precinct.", + "type": "string" + }, + "number": { + "description": "The number of the precinct.", + "type": "string" + }, + "ocdId": { + "description": "Encouraged. The OCD ID of the precinct", + "items": { + "type": "string" + }, + "type": "array" + }, + "pollingLocationId": { + "description": "ID(s) of the PollingLocation message(s) for this precinct.", + "items": { + "type": "string" + }, + "type": "array" + }, + "spatialBoundaryId": { + "description": "ID(s) of the SpatialBoundary message(s) for this precinct. Used to specify a geometrical boundary of the precinct.", + "items": { + "type": "string" + }, + "type": "array" + }, + "splitName": { + "description": "If present, this proto corresponds to one portion of split precinct. Other portions of this precinct are guaranteed to have the same `name`. If not present, this proto represents a full precicnt.", + "type": "string" + }, + "ward": { + "description": "Specifies the ward the precinct is contained within.", + "type": "string" + } + }, + "type": "object" + }, "RepresentativeInfoData": { "id": "RepresentativeInfoData", "properties": { @@ -2050,6 +2135,13 @@ "precinctId": { "type": "string" }, + "precincts": { + "description": "The precincts that match this voter's address. Will only be returned for project IDs which have been whitelisted as \"partner projects\".", + "items": { + "$ref": "Precinct" + }, + "type": "array" + }, "state": { "description": "Local Election Information for the state that the voter votes in. For the US, there will only be one element in this array.", "items": { diff --git a/civicinfo/v2/civicinfo-gen.go b/civicinfo/v2/civicinfo-gen.go index ffe385d20d8..8bdfe79e1db 100644 --- a/civicinfo/v2/civicinfo-gen.go +++ b/civicinfo/v2/civicinfo-gen.go @@ -954,9 +954,9 @@ type GeocodingSummary struct { // "typeTransitLine" - A transit line is a collection of transit legs, // associated with some invariant properties of the trips that run over // the legs. See also transitline.proto - // "typeTransitAgency" - A transit agency operates a number of lines, - // typically all in the same city, region or country. See also - // transitagency.proto + // "typeTransitAgencyDeprecatedValue" - TYPE_TRANSIT_AGENCY was moved + // to 0xC91. This deprecated enum value still exists for debugging + // purposes only. // "typeTransitTransfer" - DEPRECATED // "typeSegmentPath" - ABSTRACT // "typeRoadSign" - Road sign features have names, point geometry, @@ -1375,6 +1375,11 @@ type GeocodingSummary struct { // region-specific conventions for structuring addresses. These features // aren't necessarily defined by physical geographic features, so they // are classified as meta-features. + // "typeTransitAgency" - A transit agency operates a number of lines, + // typically all in the same city, region or country. See also + // transitagency.proto + // "typeFutureGeometry" - A feature whose geometry is planned to + // replace the geometry on another feature. // "typeEvent" - DEPRECATED // "typeEarthquake" - DEPRECATED // "typeHurricane" - DEPRECATED @@ -1779,6 +1784,82 @@ func (s *PollingLocation) UnmarshalJSON(data []byte) error { return nil } +type Precinct struct { + // AdministrationRegionId: ID of the AdministrationRegion message for + // this precinct. Corresponds to LocalityId xml tag. + AdministrationRegionId string `json:"administrationRegionId,omitempty"` + + // ContestId: ID(s) of the Contest message(s) for this precinct. + ContestId []string `json:"contestId,omitempty"` + + // DatasetId: Required. Dataset ID. What datasets our Precincts come + // from. + DatasetId int64 `json:"datasetId,omitempty,string"` + + // EarlyVoteSiteId: ID(s) of the PollingLocation message(s) for this + // precinct. + EarlyVoteSiteId []string `json:"earlyVoteSiteId,omitempty"` + + // ElectoralDistrictId: ID(s) of the ElectoralDistrict message(s) for + // this precinct. + ElectoralDistrictId []string `json:"electoralDistrictId,omitempty"` + + // Id: Required. A unique identifier for this precinct. + Id string `json:"id,omitempty"` + + // MailOnly: Specifies if the precinct runs mail-only elections. + MailOnly bool `json:"mailOnly,omitempty"` + + // Name: Required. The name of the precinct. + Name string `json:"name,omitempty"` + + // Number: The number of the precinct. + Number string `json:"number,omitempty"` + + // OcdId: Encouraged. The OCD ID of the precinct + OcdId []string `json:"ocdId,omitempty"` + + // PollingLocationId: ID(s) of the PollingLocation message(s) for this + // precinct. + PollingLocationId []string `json:"pollingLocationId,omitempty"` + + // SpatialBoundaryId: ID(s) of the SpatialBoundary message(s) for this + // precinct. Used to specify a geometrical boundary of the precinct. + SpatialBoundaryId []string `json:"spatialBoundaryId,omitempty"` + + // SplitName: If present, this proto corresponds to one portion of split + // precinct. Other portions of this precinct are guaranteed to have the + // same `name`. If not present, this proto represents a full precicnt. + SplitName string `json:"splitName,omitempty"` + + // Ward: Specifies the ward the precinct is contained within. + Ward string `json:"ward,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "AdministrationRegionId") 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. "AdministrationRegionId") + // 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 *Precinct) MarshalJSON() ([]byte, error) { + type NoMethod Precinct + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + type RepresentativeInfoData struct { // Divisions: A map of political geographic divisions that contain the // requested address, keyed by the unique Open Civic Data identifier for @@ -1998,6 +2079,11 @@ type VoterInfoResponse struct { PrecinctId string `json:"precinctId,omitempty"` + // Precincts: The precincts that match this voter's address. Will only + // be returned for project IDs which have been whitelisted as "partner + // projects". + Precincts []*Precinct `json:"precincts,omitempty"` + // State: Local Election Information for the state that the voter votes // in. For the US, there will only be one element in this array. State []*AdministrationRegion `json:"state,omitempty"` diff --git a/cloudasset/v1/cloudasset-api.json b/cloudasset/v1/cloudasset-api.json index 497dd21fd04..533d1f5ddb0 100644 --- a/cloudasset/v1/cloudasset-api.json +++ b/cloudasset/v1/cloudasset-api.json @@ -905,7 +905,7 @@ "type": "string" }, "readMask": { - "description": "Optional. A comma-separated list of fields specifying which fields to be returned in ResourceSearchResult. Only '*' or combination of top level fields can be specified. Field names of both snake_case and camelCase are supported. Examples: `\"*\"`, `\"name,location\"`, `\"name,versionedResources\"`. The read_mask paths must be valid field paths listed but not limited to (both snake_case and camelCase are supported): * name * assetType * project * displayName * description * location * labels * networkTags * kmsKey * createTime * updateTime * state * additionalAttributes * versionedResources If read_mask is not specified, all fields except versionedResources will be returned. If only '*' is specified, all fields including versionedResources will be returned. Any invalid field path will trigger INVALID_ARGUMENT error.", + "description": "Optional. A comma-separated list of fields specifying which fields to be returned in ResourceSearchResult. Only '*' or combination of top level fields can be specified. Field names of both snake_case and camelCase are supported. Examples: `\"*\"`, `\"name,location\"`, `\"name,versionedResources\"`. The read_mask paths must be valid field paths listed but not limited to (both snake_case and camelCase are supported): * name * assetType * project * displayName * description * location * tagKeys * tagValues * tagValueIds * labels * networkTags * kmsKey * createTime * updateTime * state * additionalAttributes * versionedResources If read_mask is not specified, all fields except versionedResources will be returned. If only '*' is specified, all fields including versionedResources will be returned. Any invalid field path will trigger INVALID_ARGUMENT error.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -929,7 +929,7 @@ } } }, - "revision": "20220318", + "revision": "20220412", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AccessSelector": { @@ -1219,7 +1219,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" }, @@ -3300,6 +3300,27 @@ "description": "The state of this resource. Different resources types have different state definitions that are mapped from various fields of different resource types. This field is available only when the resource's Protobuf contains it. Example: If the resource is an instance provided by Compute Engine, its state will include PROVISIONING, STAGING, RUNNING, STOPPING, SUSPENDING, SUSPENDED, REPAIRING, and TERMINATED. See `status` definition in [API Reference](https://cloud.google.com/compute/docs/reference/rest/v1/instances). If the resource is a project provided by Cloud Resource Manager, its state will include LIFECYCLE_STATE_UNSPECIFIED, ACTIVE, DELETE_REQUESTED and DELETE_IN_PROGRESS. See `lifecycleState` definition in [API Reference](https://cloud.google.com/resource-manager/reference/rest/v1/projects). To search against the `state`: * use a field query. Example: `state:RUNNING` * use a free text query. Example: `RUNNING`", "type": "string" }, + "tagKeys": { + "description": "TagKey namespaced names, in the format of {ORG_ID}/{TAG_KEY_SHORT_NAME}. To search against the `tagKeys`: * use a field query. Example: - `tagKeys:\"123456789/e*\"` - `tagKeys=\"123456789/env\"` - `tagKeys:\"env\"` * use a free text query. Example: - `env`", + "items": { + "type": "string" + }, + "type": "array" + }, + "tagValueIds": { + "description": "TagValue IDs, in the format of tagValues/{TAG_VALUE_ID}. To search against the `tagValueIds`: * use a field query. Example: - `tagValueIds:\"456\"` - `tagValueIds=\"tagValues/456\"` * use a free text query. Example: - `456`", + "items": { + "type": "string" + }, + "type": "array" + }, + "tagValues": { + "description": "TagValue namespaced names, in the format of {ORG_ID}/{TAG_KEY_SHORT_NAME}/{TAG_VALUE_SHORT_NAME}. To search against the `tagValues`: * use a field query. Example: - `tagValues:\"env\"` - `tagValues:\"env/prod\"` - `tagValues:\"123456789/env/pr*\"` - `tagValues=\"123456789/env/prod\"` * use a free text query. Example: - `prod`", + "items": { + "type": "string" + }, + "type": "array" + }, "updateTime": { "description": "The last update timestamp of this resource, at which the resource was last modified or deleted. The granularity is in seconds. Timestamp.nanos will always be 0. This field is available only when the resource's Protobuf contains it. To search against `update_time`: * use a field query. - value in seconds since unix epoch. Example: `updateTime \u003c 1609459200` - value in date string. Example: `updateTime \u003c 2021-01-01` - value in date-time string (must be quoted). Example: `updateTime \u003c \"2021-01-01T00:00:00\"`", "format": "google-datetime", diff --git a/cloudasset/v1/cloudasset-gen.go b/cloudasset/v1/cloudasset-gen.go index 98623153cc1..25c0cbfca5c 100644 --- a/cloudasset/v1/cloudasset-gen.go +++ b/cloudasset/v1/cloudasset-gen.go @@ -811,8 +811,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 @@ -4987,6 +4987,27 @@ type ResourceSearchResult struct { // `state:RUNNING` * use a free text query. Example: `RUNNING` State string `json:"state,omitempty"` + // TagKeys: TagKey namespaced names, in the format of + // {ORG_ID}/{TAG_KEY_SHORT_NAME}. To search against the `tagKeys`: * use + // a field query. Example: - `tagKeys:"123456789/e*" - + // `tagKeys="123456789/env" - `tagKeys:"env" * use a free text query. + // Example: - `env` + TagKeys []string `json:"tagKeys,omitempty"` + + // TagValueIds: TagValue IDs, in the format of tagValues/{TAG_VALUE_ID}. + // To search against the `tagValueIds`: * use a field query. Example: - + // `tagValueIds:"456" - `tagValueIds="tagValues/456" * use a free text + // query. Example: - `456` + TagValueIds []string `json:"tagValueIds,omitempty"` + + // TagValues: TagValue namespaced names, in the format of + // {ORG_ID}/{TAG_KEY_SHORT_NAME}/{TAG_VALUE_SHORT_NAME}. To search + // against the `tagValues`: * use a field query. Example: - + // `tagValues:"env" - `tagValues:"env/prod" - + // `tagValues:"123456789/env/pr*" - `tagValues="123456789/env/prod" * + // use a free text query. Example: - `prod` + TagValues []string `json:"tagValues,omitempty"` + // UpdateTime: The last update timestamp of this resource, at which the // resource was last modified or deleted. The granularity is in seconds. // Timestamp.nanos will always be 0. This field is available only when @@ -9528,12 +9549,12 @@ func (c *V1SearchAllResourcesCall) Query(query string) *V1SearchAllResourcesCall // "name,versionedResources". The read_mask paths must be valid field // paths listed but not limited to (both snake_case and camelCase are // supported): * name * assetType * project * displayName * description -// * location * labels * networkTags * kmsKey * createTime * updateTime -// * state * additionalAttributes * versionedResources If read_mask is -// not specified, all fields except versionedResources will be returned. -// If only '*' is specified, all fields including versionedResources -// will be returned. Any invalid field path will trigger -// INVALID_ARGUMENT error. +// * location * tagKeys * tagValues * tagValueIds * labels * networkTags +// * kmsKey * createTime * updateTime * state * additionalAttributes * +// versionedResources If read_mask is not specified, all fields except +// versionedResources will be returned. If only '*' is specified, all +// fields including versionedResources will be returned. Any invalid +// field path will trigger INVALID_ARGUMENT error. func (c *V1SearchAllResourcesCall) ReadMask(readMask string) *V1SearchAllResourcesCall { c.urlParams_.Set("readMask", readMask) return c @@ -9674,7 +9695,7 @@ func (c *V1SearchAllResourcesCall) Do(opts ...googleapi.CallOption) (*SearchAllR // "type": "string" // }, // "readMask": { - // "description": "Optional. A comma-separated list of fields specifying which fields to be returned in ResourceSearchResult. Only '*' or combination of top level fields can be specified. Field names of both snake_case and camelCase are supported. Examples: `\"*\"`, `\"name,location\"`, `\"name,versionedResources\"`. The read_mask paths must be valid field paths listed but not limited to (both snake_case and camelCase are supported): * name * assetType * project * displayName * description * location * labels * networkTags * kmsKey * createTime * updateTime * state * additionalAttributes * versionedResources If read_mask is not specified, all fields except versionedResources will be returned. If only '*' is specified, all fields including versionedResources will be returned. Any invalid field path will trigger INVALID_ARGUMENT error.", + // "description": "Optional. A comma-separated list of fields specifying which fields to be returned in ResourceSearchResult. Only '*' or combination of top level fields can be specified. Field names of both snake_case and camelCase are supported. Examples: `\"*\"`, `\"name,location\"`, `\"name,versionedResources\"`. The read_mask paths must be valid field paths listed but not limited to (both snake_case and camelCase are supported): * name * assetType * project * displayName * description * location * tagKeys * tagValues * tagValueIds * labels * networkTags * kmsKey * createTime * updateTime * state * additionalAttributes * versionedResources If read_mask is not specified, all fields except versionedResources will be returned. If only '*' is specified, all fields including versionedResources will be returned. Any invalid field path will trigger INVALID_ARGUMENT error.", // "format": "google-fieldmask", // "location": "query", // "type": "string" diff --git a/cloudasset/v1beta1/cloudasset-api.json b/cloudasset/v1beta1/cloudasset-api.json index 80db99c998d..7fa848aae5e 100644 --- a/cloudasset/v1beta1/cloudasset-api.json +++ b/cloudasset/v1beta1/cloudasset-api.json @@ -411,7 +411,7 @@ } } }, - "revision": "20211125", + "revision": "20220412", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -546,7 +546,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" }, diff --git a/cloudasset/v1beta1/cloudasset-gen.go b/cloudasset/v1beta1/cloudasset-gen.go index bc94c4d850e..5eab16cfe7f 100644 --- a/cloudasset/v1beta1/cloudasset-gen.go +++ b/cloudasset/v1beta1/cloudasset-gen.go @@ -458,8 +458,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 diff --git a/cloudasset/v1p1beta1/cloudasset-api.json b/cloudasset/v1p1beta1/cloudasset-api.json index a94fb826599..f650d5424a0 100644 --- a/cloudasset/v1p1beta1/cloudasset-api.json +++ b/cloudasset/v1p1beta1/cloudasset-api.json @@ -207,7 +207,7 @@ } } }, - "revision": "20211125", + "revision": "20220412", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -286,7 +286,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" }, diff --git a/cloudasset/v1p1beta1/cloudasset-gen.go b/cloudasset/v1p1beta1/cloudasset-gen.go index e7afba746c6..ba15a5fcc39 100644 --- a/cloudasset/v1p1beta1/cloudasset-gen.go +++ b/cloudasset/v1p1beta1/cloudasset-gen.go @@ -301,8 +301,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 diff --git a/cloudasset/v1p4beta1/cloudasset-api.json b/cloudasset/v1p4beta1/cloudasset-api.json index 168f2a42152..12d76479f46 100644 --- a/cloudasset/v1p4beta1/cloudasset-api.json +++ b/cloudasset/v1p4beta1/cloudasset-api.json @@ -221,7 +221,7 @@ } } }, - "revision": "20211125", + "revision": "20220412", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AccessSelector": { @@ -350,7 +350,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" }, diff --git a/cloudasset/v1p4beta1/cloudasset-gen.go b/cloudasset/v1p4beta1/cloudasset-gen.go index a30d82ab457..36464a3e1f7 100644 --- a/cloudasset/v1p4beta1/cloudasset-gen.go +++ b/cloudasset/v1p4beta1/cloudasset-gen.go @@ -373,8 +373,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 diff --git a/cloudasset/v1p5beta1/cloudasset-api.json b/cloudasset/v1p5beta1/cloudasset-api.json index 75ddb27d345..3abeb00ed56 100644 --- a/cloudasset/v1p5beta1/cloudasset-api.json +++ b/cloudasset/v1p5beta1/cloudasset-api.json @@ -177,7 +177,7 @@ } } }, - "revision": "20211125", + "revision": "20220412", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -305,7 +305,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" }, diff --git a/cloudasset/v1p5beta1/cloudasset-gen.go b/cloudasset/v1p5beta1/cloudasset-gen.go index 8ccd8f9c22e..3530060a631 100644 --- a/cloudasset/v1p5beta1/cloudasset-gen.go +++ b/cloudasset/v1p5beta1/cloudasset-gen.go @@ -376,8 +376,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 diff --git a/cloudasset/v1p7beta1/cloudasset-api.json b/cloudasset/v1p7beta1/cloudasset-api.json index 313abdb02f6..7a56e0c74c1 100644 --- a/cloudasset/v1p7beta1/cloudasset-api.json +++ b/cloudasset/v1p7beta1/cloudasset-api.json @@ -167,7 +167,7 @@ } } }, - "revision": "20211125", + "revision": "20220412", "rootUrl": "https://cloudasset.googleapis.com/", "schemas": { "AnalyzeIamPolicyLongrunningMetadata": { @@ -246,7 +246,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" }, diff --git a/cloudasset/v1p7beta1/cloudasset-gen.go b/cloudasset/v1p7beta1/cloudasset-gen.go index 2d0c5d18c2f..6665d0e8452 100644 --- a/cloudasset/v1p7beta1/cloudasset-gen.go +++ b/cloudasset/v1p7beta1/cloudasset-gen.go @@ -301,8 +301,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 diff --git a/dataproc/v1/dataproc-api.json b/dataproc/v1/dataproc-api.json index 90746f11491..1727848627a 100644 --- a/dataproc/v1/dataproc-api.json +++ b/dataproc/v1/dataproc-api.json @@ -2444,7 +2444,7 @@ } } }, - "revision": "20220324", + "revision": "20220404", "rootUrl": "https://dataproc.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -2508,6 +2508,21 @@ }, "type": "object" }, + "AuxiliaryServicesConfig": { + "description": "Auxiliary services configuration for a Cluster.", + "id": "AuxiliaryServicesConfig", + "properties": { + "metastoreConfig": { + "$ref": "MetastoreConfig", + "description": "Optional. The Hive Metastore configuration for this workload." + }, + "sparkHistoryServerConfig": { + "$ref": "SparkHistoryServerConfig", + "description": "Optional. The Spark History Server configuration for the workload." + } + }, + "type": "object" + }, "BasicAutoscalingAlgorithm": { "description": "Basic algorithm for autoscaling.", "id": "BasicAutoscalingAlgorithm", @@ -2735,7 +2750,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" }, @@ -2769,7 +2784,7 @@ }, "config": { "$ref": "ClusterConfig", - "description": "Optional. The cluster config for a cluster of Compute Engine Instances. Note that Dataproc may set default values, and values may change when clusters are updated." + "description": "Optional. The cluster config for a cluster of Compute Engine Instances. Note that Dataproc may set default values, and values may change when clusters are updated.Exactly one of ClusterConfig or VirtualClusterConfig must be specified." }, "labels": { "additionalProperties": { @@ -2799,6 +2814,10 @@ }, "readOnly": true, "type": "array" + }, + "virtualClusterConfig": { + "$ref": "VirtualClusterConfig", + "description": "Optional. The virtual cluster config, used when creating a Dataproc cluster that does not directly control the underlying compute resources, for example, when creating a Dataproc-on-GKE cluster (https://cloud.google.com/dataproc/docs/concepts/jobs/dataproc-gke#create-a-dataproc-on-gke-cluster). Note that Dataproc may set default values, and values may change when clusters are updated. Exactly one of config or virtualClusterConfig must be specified." } }, "type": "object" @@ -2833,7 +2852,7 @@ }, "gkeClusterConfig": { "$ref": "GkeClusterConfig", - "description": "Optional. BETA. The Kubernetes Engine config for Dataproc clusters deployed to Kubernetes. Setting this is considered mutually exclusive with Compute Engine-based options such as gce_cluster_config, master_config, worker_config, secondary_worker_config, and autoscaling_config." + "description": "Optional. Deprecated. Use VirtualClusterConfig based clusters instead. BETA. The Kubernetes Engine config for Dataproc clusters deployed to Kubernetes. Setting this is considered mutually exclusive with Compute Engine-based options such as gce_cluster_config, master_config, worker_config, secondary_worker_config, and autoscaling_config." }, "initializationActions": { "description": "Optional. Commands to execute on each node after config is completed. By default, executables are run on master and all worker nodes. You can test a node's role metadata to run an executable on a master or worker node, as shown below using curl (you can also use wget): ROLE=$(curl -H Metadata-Flavor:Google http://metadata/computeMetadata/v1/instance/attributes/dataproc-role) if [[ \"${ROLE}\" == 'Master' ]]; then ... master specific actions ... else ... worker specific actions ... fi ", @@ -3377,9 +3396,150 @@ "description": "The cluster's GKE config.", "id": "GkeClusterConfig", "properties": { + "gkeClusterTarget": { + "description": "Optional. A target GKE cluster to deploy to. It must be in the same project and region as the Dataproc cluster (the GKE cluster can be zonal or regional). Format: 'projects/{project}/locations/{location}/clusters/{cluster_id}'", + "type": "string" + }, "namespacedGkeDeploymentTarget": { "$ref": "NamespacedGkeDeploymentTarget", - "description": "Optional. A target for the deployment." + "description": "Optional. Deprecated. Use gkeClusterTarget. Used only for the deprecated beta. A target for the deployment." + }, + "nodePoolTarget": { + "description": "Optional. GKE NodePools where workloads will be scheduled. At least one node pool must be assigned the 'default' role. Each role can be given to only a single NodePoolTarget. All NodePools must have the same location settings. If a nodePoolTarget is not specified, Dataproc constructs a default nodePoolTarget.", + "items": { + "$ref": "GkeNodePoolTarget" + }, + "type": "array" + } + }, + "type": "object" + }, + "GkeNodeConfig": { + "description": "Parameters that describe cluster nodes.", + "id": "GkeNodeConfig", + "properties": { + "accelerators": { + "description": "Optional. A list of hardware accelerators (https://cloud.google.com/compute/docs/gpus) to attach to each node.", + "items": { + "$ref": "GkeNodePoolAcceleratorConfig" + }, + "type": "array" + }, + "localSsdCount": { + "description": "Optional. The number of local SSD disks to attach to the node, which is limited by the maximum number of disks allowable per zone (see Adding Local SSDs (https://cloud.google.com/compute/docs/disks/local-ssd)).", + "format": "int32", + "type": "integer" + }, + "machineType": { + "description": "Optional. The name of a Compute Engine machine type (https://cloud.google.com/compute/docs/machine-types).", + "type": "string" + }, + "minCpuPlatform": { + "description": "Optional. Minimum CPU platform (https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform) to be used by this instance. The instance may be scheduled on the specified or a newer CPU platform. Specify the friendly names of CPU platforms, such as \"Intel Haswell\"` or Intel Sandy Bridge\".", + "type": "string" + }, + "preemptible": { + "description": "Optional. Whether the nodes are created as preemptible VM instances (https://cloud.google.com/compute/docs/instances/preemptible).", + "type": "boolean" + }, + "spot": { + "description": "Optional. Spot flag for enabling Spot VM, which is a rebrand of the existing preemptible flag.", + "type": "boolean" + } + }, + "type": "object" + }, + "GkeNodePoolAcceleratorConfig": { + "description": "A GkeNodeConfigAcceleratorConfig represents a Hardware Accelerator request for a NodePool.", + "id": "GkeNodePoolAcceleratorConfig", + "properties": { + "acceleratorCount": { + "description": "The number of accelerator cards exposed to an instance.", + "format": "int64", + "type": "string" + }, + "acceleratorType": { + "description": "The accelerator type resource namename (see GPUs on Compute Engine).", + "type": "string" + }, + "gpuPartitionSize": { + "description": "Size of partitions to create on the GPU. Valid values are described in the NVIDIA mig user guide (https://docs.nvidia.com/datacenter/tesla/mig-user-guide/#partitioning).", + "type": "string" + } + }, + "type": "object" + }, + "GkeNodePoolAutoscalingConfig": { + "description": "GkeNodePoolAutoscaling contains information the cluster autoscaler needs to adjust the size of the node pool to the current cluster usage.", + "id": "GkeNodePoolAutoscalingConfig", + "properties": { + "maxNodeCount": { + "description": "The maximum number of nodes in the NodePool. Must be \u003e= min_node_count. Note: Quota must be sufficient to scale up the cluster.", + "format": "int32", + "type": "integer" + }, + "minNodeCount": { + "description": "The minimum number of nodes in the NodePool. Must be \u003e= 0 and \u003c= max_node_count.", + "format": "int32", + "type": "integer" + } + }, + "type": "object" + }, + "GkeNodePoolConfig": { + "description": "The configuration of a GKE NodePool used by a Dataproc-on-GKE cluster (https://cloud.google.com/dataproc/docs/concepts/jobs/dataproc-gke#create-a-dataproc-on-gke-cluster).", + "id": "GkeNodePoolConfig", + "properties": { + "autoscaling": { + "$ref": "GkeNodePoolAutoscalingConfig", + "description": "Optional. The autoscaler configuration for this NodePool. The autoscaler is enabled only when a valid configuration is present." + }, + "config": { + "$ref": "GkeNodeConfig", + "description": "Optional. The node pool configuration." + }, + "locations": { + "description": "Optional. The list of Compute Engine zones (https://cloud.google.com/compute/docs/zones#available) where NodePool's nodes will be located.Note: Currently, only one zone may be specified.If a location is not specified during NodePool creation, Dataproc will choose a location.", + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "GkeNodePoolTarget": { + "description": "GKE NodePools that Dataproc workloads run on.", + "id": "GkeNodePoolTarget", + "properties": { + "nodePool": { + "description": "Required. The target GKE NodePool. Format: 'projects/{project}/locations/{location}/clusters/{cluster}/nodePools/{node_pool}'", + "type": "string" + }, + "nodePoolConfig": { + "$ref": "GkeNodePoolConfig", + "description": "Input only. The configuration for the GKE NodePool.If specified, Dataproc attempts to create a NodePool with the specified shape. If one with the same name already exists, it is verified against all specified fields. If a field differs, the virtual cluster creation will fail.If omitted, any NodePool with the specified name is used. If a NodePool with the specified name does not exist, Dataproc create a NodePool with default values.This is an input only field. It will not be returned by the API." + }, + "roles": { + "description": "Required. The types of role for a GKE NodePool", + "items": { + "enum": [ + "ROLE_UNSPECIFIED", + "DEFAULT", + "CONTROLLER", + "SPARK_DRIVER", + "SPARK_EXECUTOR" + ], + "enumDescriptions": [ + "Role is unspecified.", + "Any roles that are not directly assigned to a NodePool run on the default role's NodePool.", + "Run controllers and webhooks.", + "Run spark driver.", + "Run spark executors." + ], + "type": "string" + }, + "type": "array" } }, "type": "object" @@ -3964,6 +4124,46 @@ }, "type": "object" }, + "KubernetesClusterConfig": { + "description": "The configuration for running the Dataproc cluster on Kubernetes.", + "id": "KubernetesClusterConfig", + "properties": { + "gkeClusterConfig": { + "$ref": "GkeClusterConfig", + "description": "Required. The configuration for running the Dataproc cluster on GKE." + }, + "kubernetesNamespace": { + "description": "Optional. A namespace within the Kubernetes cluster to deploy into. If this namespace does not exist, it is created. If it exists, Dataproc verifies that another Dataproc VirtualCluster is not installed into it. If not specified, the name of the Dataproc Cluster is used.", + "type": "string" + }, + "kubernetesSoftwareConfig": { + "$ref": "KubernetesSoftwareConfig", + "description": "Optional. The software configuration for this Dataproc cluster running on Kubernetes." + } + }, + "type": "object" + }, + "KubernetesSoftwareConfig": { + "description": "The software configuration for this Dataproc cluster running on Kubernetes.", + "id": "KubernetesSoftwareConfig", + "properties": { + "componentVersion": { + "additionalProperties": { + "type": "string" + }, + "description": "The components that should be installed in this Dataproc cluster. The key must be a string from the KubernetesComponent enumeration. The value is the version of the software to be installed. At least one entry must be specified.", + "type": "object" + }, + "properties": { + "additionalProperties": { + "type": "string" + }, + "description": "The properties to set on daemon config files.Property keys are specified in prefix:property format, for example spark:spark.kubernetes.container.image. The following are supported prefixes and their mappings: spark: spark-defaults.confFor more information, see Cluster properties (https://cloud.google.com/dataproc/docs/concepts/cluster-properties).", + "type": "object" + } + }, + "type": "object" + }, "LifecycleConfig": { "description": "Specifies the cluster auto-delete schedule configuration.", "id": "LifecycleConfig", @@ -4230,7 +4430,7 @@ "type": "object" }, "NamespacedGkeDeploymentTarget": { - "description": "A full, namespace-isolated deployment target for an existing GKE cluster.", + "description": "Deprecated. Used only for the deprecated beta. A full, namespace-isolated deployment target for an existing GKE cluster.", "id": "NamespacedGkeDeploymentTarget", "properties": { "clusterNamespace": { @@ -4813,7 +5013,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." } }, "type": "object" @@ -5316,7 +5516,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" }, @@ -5353,6 +5553,25 @@ }, "type": "object" }, + "VirtualClusterConfig": { + "description": "Dataproc cluster config for a cluster that does not directly control the underlying compute resources, such as a Dataproc-on-GKE cluster (https://cloud.google.com/dataproc/docs/concepts/jobs/dataproc-gke#create-a-dataproc-on-gke-cluster).", + "id": "VirtualClusterConfig", + "properties": { + "auxiliaryServicesConfig": { + "$ref": "AuxiliaryServicesConfig", + "description": "Optional. Configuration of auxiliary services used by this cluster." + }, + "kubernetesClusterConfig": { + "$ref": "KubernetesClusterConfig", + "description": "Required. The configuration for running the Dataproc cluster on Kubernetes." + }, + "stagingBucket": { + "description": "Optional. A Storage bucket used to stage job dependencies, config files, and job driver console output. If you do not specify a staging bucket, Cloud Dataproc will determine a Cloud Storage location (US, ASIA, or EU) for your cluster's staging bucket according to the Compute Engine zone where your cluster is deployed, and then create and manage this project-level, per-location bucket (see Dataproc staging and temp buckets (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/staging-bucket)). This field requires a Cloud Storage bucket name, not a gs://... URI to a Cloud Storage bucket.", + "type": "string" + } + }, + "type": "object" + }, "WorkflowGraph": { "description": "The workflow graph.", "id": "WorkflowGraph", diff --git a/dataproc/v1/dataproc-gen.go b/dataproc/v1/dataproc-gen.go index 4acfb81cb8f..82f7723b5d2 100644 --- a/dataproc/v1/dataproc-gen.go +++ b/dataproc/v1/dataproc-gen.go @@ -414,6 +414,41 @@ func (s *AutoscalingPolicy) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// AuxiliaryServicesConfig: Auxiliary services configuration for a +// Cluster. +type AuxiliaryServicesConfig struct { + // MetastoreConfig: Optional. The Hive Metastore configuration for this + // workload. + MetastoreConfig *MetastoreConfig `json:"metastoreConfig,omitempty"` + + // SparkHistoryServerConfig: Optional. The Spark History Server + // configuration for the workload. + SparkHistoryServerConfig *SparkHistoryServerConfig `json:"sparkHistoryServerConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "MetastoreConfig") 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. "MetastoreConfig") 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 *AuxiliaryServicesConfig) MarshalJSON() ([]byte, error) { + type NoMethod AuxiliaryServicesConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // BasicAutoscalingAlgorithm: Basic algorithm for autoscaling. type BasicAutoscalingAlgorithm struct { // CooldownPeriod: Optional. Duration between scaling events. A scaling @@ -711,8 +746,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: allUsers: A + // 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 who is authenticated with a Google @@ -789,7 +824,8 @@ type Cluster struct { // Config: Optional. The cluster config for a cluster of Compute Engine // Instances. Note that Dataproc may set default values, and values may - // change when clusters are updated. + // change when clusters are updated.Exactly one of ClusterConfig or + // VirtualClusterConfig must be specified. Config *ClusterConfig `json:"config,omitempty"` // Labels: Optional. The labels to associate with this cluster. Label @@ -815,6 +851,16 @@ type Cluster struct { // StatusHistory: Output only. The previous cluster status. StatusHistory []*ClusterStatus `json:"statusHistory,omitempty"` + // VirtualClusterConfig: Optional. The virtual cluster config, used when + // creating a Dataproc cluster that does not directly control the + // underlying compute resources, for example, when creating a + // Dataproc-on-GKE cluster + // (https://cloud.google.com/dataproc/docs/concepts/jobs/dataproc-gke#create-a-dataproc-on-gke-cluster). + // Note that Dataproc may set default values, and values may change when + // clusters are updated. Exactly one of config or virtualClusterConfig + // must be specified. + VirtualClusterConfig *VirtualClusterConfig `json:"virtualClusterConfig,omitempty"` + // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` @@ -876,7 +922,8 @@ type ClusterConfig struct { // for all instances in a cluster. GceClusterConfig *GceClusterConfig `json:"gceClusterConfig,omitempty"` - // GkeClusterConfig: Optional. BETA. The Kubernetes Engine config for + // GkeClusterConfig: Optional. Deprecated. Use VirtualClusterConfig + // based clusters instead. BETA. The Kubernetes Engine config for // Dataproc clusters deployed to Kubernetes. Setting this is considered // mutually exclusive with Compute Engine-based options such as // gce_cluster_config, master_config, worker_config, @@ -1787,25 +1834,39 @@ func (s *GetPolicyOptions) MarshalJSON() ([]byte, error) { // GkeClusterConfig: The cluster's GKE config. type GkeClusterConfig struct { - // NamespacedGkeDeploymentTarget: Optional. A target for the deployment. + // GkeClusterTarget: Optional. A target GKE cluster to deploy to. It + // must be in the same project and region as the Dataproc cluster (the + // GKE cluster can be zonal or regional). Format: + // 'projects/{project}/locations/{location}/clusters/{cluster_id}' + GkeClusterTarget string `json:"gkeClusterTarget,omitempty"` + + // NamespacedGkeDeploymentTarget: Optional. Deprecated. Use + // gkeClusterTarget. Used only for the deprecated beta. A target for the + // deployment. NamespacedGkeDeploymentTarget *NamespacedGkeDeploymentTarget `json:"namespacedGkeDeploymentTarget,omitempty"` - // ForceSendFields is a list of field names (e.g. - // "NamespacedGkeDeploymentTarget") 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. + // NodePoolTarget: Optional. GKE NodePools where workloads will be + // scheduled. At least one node pool must be assigned the 'default' + // role. Each role can be given to only a single NodePoolTarget. All + // NodePools must have the same location settings. If a nodePoolTarget + // is not specified, Dataproc constructs a default nodePoolTarget. + NodePoolTarget []*GkeNodePoolTarget `json:"nodePoolTarget,omitempty"` + + // ForceSendFields is a list of field names (e.g. "GkeClusterTarget") 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. - // "NamespacedGkeDeploymentTarget") 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 is a list of field names (e.g. "GkeClusterTarget") 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:"-"` } @@ -1815,6 +1876,230 @@ func (s *GkeClusterConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GkeNodeConfig: Parameters that describe cluster nodes. +type GkeNodeConfig struct { + // Accelerators: Optional. A list of hardware accelerators + // (https://cloud.google.com/compute/docs/gpus) to attach to each node. + Accelerators []*GkeNodePoolAcceleratorConfig `json:"accelerators,omitempty"` + + // LocalSsdCount: Optional. The number of local SSD disks to attach to + // the node, which is limited by the maximum number of disks allowable + // per zone (see Adding Local SSDs + // (https://cloud.google.com/compute/docs/disks/local-ssd)). + LocalSsdCount int64 `json:"localSsdCount,omitempty"` + + // MachineType: Optional. The name of a Compute Engine machine type + // (https://cloud.google.com/compute/docs/machine-types). + MachineType string `json:"machineType,omitempty"` + + // MinCpuPlatform: Optional. Minimum CPU platform + // (https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform) + // to be used by this instance. The instance may be scheduled on the + // specified or a newer CPU platform. Specify the friendly names of CPU + // platforms, such as "Intel Haswell" or Intel Sandy Bridge". + MinCpuPlatform string `json:"minCpuPlatform,omitempty"` + + // Preemptible: Optional. Whether the nodes are created as preemptible + // VM instances + // (https://cloud.google.com/compute/docs/instances/preemptible). + Preemptible bool `json:"preemptible,omitempty"` + + // Spot: Optional. Spot flag for enabling Spot VM, which is a rebrand of + // the existing preemptible flag. + Spot bool `json:"spot,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Accelerators") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. 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. "Accelerators") 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 *GkeNodeConfig) MarshalJSON() ([]byte, error) { + type NoMethod GkeNodeConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GkeNodePoolAcceleratorConfig: A GkeNodeConfigAcceleratorConfig +// represents a Hardware Accelerator request for a NodePool. +type GkeNodePoolAcceleratorConfig struct { + // AcceleratorCount: The number of accelerator cards exposed to an + // instance. + AcceleratorCount int64 `json:"acceleratorCount,omitempty,string"` + + // AcceleratorType: The accelerator type resource namename (see GPUs on + // Compute Engine). + AcceleratorType string `json:"acceleratorType,omitempty"` + + // GpuPartitionSize: Size of partitions to create on the GPU. Valid + // values are described in the NVIDIA mig user guide + // (https://docs.nvidia.com/datacenter/tesla/mig-user-guide/#partitioning). + GpuPartitionSize string `json:"gpuPartitionSize,omitempty"` + + // ForceSendFields is a list of field names (e.g. "AcceleratorCount") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. 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. "AcceleratorCount") 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 *GkeNodePoolAcceleratorConfig) MarshalJSON() ([]byte, error) { + type NoMethod GkeNodePoolAcceleratorConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GkeNodePoolAutoscalingConfig: GkeNodePoolAutoscaling contains +// information the cluster autoscaler needs to adjust the size of the +// node pool to the current cluster usage. +type GkeNodePoolAutoscalingConfig struct { + // MaxNodeCount: The maximum number of nodes in the NodePool. Must be >= + // min_node_count. Note: Quota must be sufficient to scale up the + // cluster. + MaxNodeCount int64 `json:"maxNodeCount,omitempty"` + + // MinNodeCount: The minimum number of nodes in the NodePool. Must be >= + // 0 and <= max_node_count. + MinNodeCount int64 `json:"minNodeCount,omitempty"` + + // ForceSendFields is a list of field names (e.g. "MaxNodeCount") 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. "MaxNodeCount") 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 *GkeNodePoolAutoscalingConfig) MarshalJSON() ([]byte, error) { + type NoMethod GkeNodePoolAutoscalingConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GkeNodePoolConfig: The configuration of a GKE NodePool used by a +// Dataproc-on-GKE cluster +// (https://cloud.google.com/dataproc/docs/concepts/jobs/dataproc-gke#create-a-dataproc-on-gke-cluster). +type GkeNodePoolConfig struct { + // Autoscaling: Optional. The autoscaler configuration for this + // NodePool. The autoscaler is enabled only when a valid configuration + // is present. + Autoscaling *GkeNodePoolAutoscalingConfig `json:"autoscaling,omitempty"` + + // Config: Optional. The node pool configuration. + Config *GkeNodeConfig `json:"config,omitempty"` + + // Locations: Optional. The list of Compute Engine zones + // (https://cloud.google.com/compute/docs/zones#available) where + // NodePool's nodes will be located.Note: Currently, only one zone may + // be specified.If a location is not specified during NodePool creation, + // Dataproc will choose a location. + Locations []string `json:"locations,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Autoscaling") 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. "Autoscaling") 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 *GkeNodePoolConfig) MarshalJSON() ([]byte, error) { + type NoMethod GkeNodePoolConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// GkeNodePoolTarget: GKE NodePools that Dataproc workloads run on. +type GkeNodePoolTarget struct { + // NodePool: Required. The target GKE NodePool. Format: + // 'projects/{project}/locations/{location}/clusters/{cluster}/nodePools/ + // {node_pool}' + NodePool string `json:"nodePool,omitempty"` + + // NodePoolConfig: Input only. The configuration for the GKE NodePool.If + // specified, Dataproc attempts to create a NodePool with the specified + // shape. If one with the same name already exists, it is verified + // against all specified fields. If a field differs, the virtual cluster + // creation will fail.If omitted, any NodePool with the specified name + // is used. If a NodePool with the specified name does not exist, + // Dataproc create a NodePool with default values.This is an input only + // field. It will not be returned by the API. + NodePoolConfig *GkeNodePoolConfig `json:"nodePoolConfig,omitempty"` + + // Roles: Required. The types of role for a GKE NodePool + // + // Possible values: + // "ROLE_UNSPECIFIED" - Role is unspecified. + // "DEFAULT" - Any roles that are not directly assigned to a NodePool + // run on the default role's NodePool. + // "CONTROLLER" - Run controllers and webhooks. + // "SPARK_DRIVER" - Run spark driver. + // "SPARK_EXECUTOR" - Run spark executors. + Roles []string `json:"roles,omitempty"` + + // ForceSendFields is a list of field names (e.g. "NodePool") 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. "NodePool") 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 *GkeNodePoolTarget) MarshalJSON() ([]byte, error) { + type NoMethod GkeNodePoolTarget + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // HadoopJob: A Dataproc job for running Apache Hadoop MapReduce // (https://hadoop.apache.org/docs/current/hadoop-mapreduce-client/hadoop-mapreduce-client-core/MapReduceTutorial.html) // jobs on Apache Hadoop YARN @@ -2679,6 +2964,89 @@ func (s *KerberosConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// KubernetesClusterConfig: The configuration for running the Dataproc +// cluster on Kubernetes. +type KubernetesClusterConfig struct { + // GkeClusterConfig: Required. The configuration for running the + // Dataproc cluster on GKE. + GkeClusterConfig *GkeClusterConfig `json:"gkeClusterConfig,omitempty"` + + // KubernetesNamespace: Optional. A namespace within the Kubernetes + // cluster to deploy into. If this namespace does not exist, it is + // created. If it exists, Dataproc verifies that another Dataproc + // VirtualCluster is not installed into it. If not specified, the name + // of the Dataproc Cluster is used. + KubernetesNamespace string `json:"kubernetesNamespace,omitempty"` + + // KubernetesSoftwareConfig: Optional. The software configuration for + // this Dataproc cluster running on Kubernetes. + KubernetesSoftwareConfig *KubernetesSoftwareConfig `json:"kubernetesSoftwareConfig,omitempty"` + + // ForceSendFields is a list of field names (e.g. "GkeClusterConfig") 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. "GkeClusterConfig") 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 *KubernetesClusterConfig) MarshalJSON() ([]byte, error) { + type NoMethod KubernetesClusterConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// KubernetesSoftwareConfig: The software configuration for this +// Dataproc cluster running on Kubernetes. +type KubernetesSoftwareConfig struct { + // ComponentVersion: The components that should be installed in this + // Dataproc cluster. The key must be a string from the + // KubernetesComponent enumeration. The value is the version of the + // software to be installed. At least one entry must be specified. + ComponentVersion map[string]string `json:"componentVersion,omitempty"` + + // Properties: The properties to set on daemon config files.Property + // keys are specified in prefix:property format, for example + // spark:spark.kubernetes.container.image. The following are supported + // prefixes and their mappings: spark: spark-defaults.confFor more + // information, see Cluster properties + // (https://cloud.google.com/dataproc/docs/concepts/cluster-properties). + Properties map[string]string `json:"properties,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ComponentVersion") 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. "ComponentVersion") 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 *KubernetesSoftwareConfig) MarshalJSON() ([]byte, error) { + type NoMethod KubernetesSoftwareConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // LifecycleConfig: Specifies the cluster auto-delete schedule // configuration. type LifecycleConfig struct { @@ -3143,8 +3511,9 @@ func (s *Metric) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// NamespacedGkeDeploymentTarget: A full, namespace-isolated deployment -// target for an existing GKE cluster. +// NamespacedGkeDeploymentTarget: Deprecated. Used only for the +// deprecated beta. A full, namespace-isolated deployment target for an +// existing GKE cluster. type NamespacedGkeDeploymentTarget struct { // ClusterNamespace: Optional. A namespace within the GKE cluster to // deploy into. @@ -4105,7 +4474,7 @@ func (s *SessionOperationMetadata) 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 (such as + // is a valid policy but certain Google Cloud services (such as // Projects) might reject them. Policy *Policy `json:"policy,omitempty"` @@ -4949,8 +5318,8 @@ func (s *TemplateParameter) 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 - // allowed. For more information see IAM Overview + // 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"` @@ -5039,6 +5408,56 @@ func (s *ValueValidation) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// VirtualClusterConfig: Dataproc cluster config for a cluster that does +// not directly control the underlying compute resources, such as a +// Dataproc-on-GKE cluster +// (https://cloud.google.com/dataproc/docs/concepts/jobs/dataproc-gke#create-a-dataproc-on-gke-cluster). +type VirtualClusterConfig struct { + // AuxiliaryServicesConfig: Optional. Configuration of auxiliary + // services used by this cluster. + AuxiliaryServicesConfig *AuxiliaryServicesConfig `json:"auxiliaryServicesConfig,omitempty"` + + // KubernetesClusterConfig: Required. The configuration for running the + // Dataproc cluster on Kubernetes. + KubernetesClusterConfig *KubernetesClusterConfig `json:"kubernetesClusterConfig,omitempty"` + + // StagingBucket: Optional. A Storage bucket used to stage job + // dependencies, config files, and job driver console output. If you do + // not specify a staging bucket, Cloud Dataproc will determine a Cloud + // Storage location (US, ASIA, or EU) for your cluster's staging bucket + // according to the Compute Engine zone where your cluster is deployed, + // and then create and manage this project-level, per-location bucket + // (see Dataproc staging and temp buckets + // (https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/staging-bucket)). + // This field requires a Cloud Storage bucket name, not a gs://... URI + // to a Cloud Storage bucket. + StagingBucket string `json:"stagingBucket,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "AuxiliaryServicesConfig") 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. "AuxiliaryServicesConfig") + // 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 *VirtualClusterConfig) MarshalJSON() ([]byte, error) { + type NoMethod VirtualClusterConfig + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // WorkflowGraph: The workflow graph. type WorkflowGraph struct { // Nodes: Output only. The workflow nodes. diff --git a/displayvideo/v1/displayvideo-api.json b/displayvideo/v1/displayvideo-api.json index ece0639771a..7a75c4bbd32 100644 --- a/displayvideo/v1/displayvideo-api.json +++ b/displayvideo/v1/displayvideo-api.json @@ -2508,7 +2508,7 @@ "type": "string" }, "orderBy": { - "description": "Field by which to sort the list. Acceptable values are: * \"displayName\" (default) * \"entityStatus\" * “flight.dateRange.endDate” * \"updateTime\" The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `displayName desc`.", + "description": "Field by which to sort the list. Acceptable values are: * `displayName` (default) * `entityStatus` * `flight.dateRange.endDate` * `updateTime` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `displayName desc`.", "location": "query", "type": "string" }, @@ -7844,7 +7844,7 @@ } } }, - "revision": "20220324", + "revision": "20220411", "rootUrl": "https://displayvideo.googleapis.com/", "schemas": { "ActivateManualTriggerRequest": { @@ -8186,7 +8186,7 @@ "id": "AgeRangeAssignedTargetingOptionDetails", "properties": { "ageRange": { - "description": "The age range of an audience. We only support targeting a continuous age range of an audience. Thus, the age range represented in this field can be 1) targeted solely, or, 2) part of a larger continuous age range. The reach of a continuous age range targeting can be expanded by also targeting an audience of an unknown age. Output only in v1. Required in v2.", + "description": "The age range of an audience. We only support targeting a continuous age range of an audience. Thus, the age range represented in this field can be 1) targeted solely, or, 2) part of a larger continuous age range. The reach of a continuous age range targeting can be expanded by also targeting an audience of an unknown age. Output only in v1.", "enum": [ "AGE_RANGE_UNSPECIFIED", "AGE_RANGE_18_24", @@ -8851,7 +8851,7 @@ "id": "AudioContentTypeAssignedTargetingOptionDetails", "properties": { "audioContentType": { - "description": "The audio content type. Output only in v1. Required in v2.", + "description": "The audio content type. Output only in v1.", "enum": [ "AUDIO_CONTENT_TYPE_UNSPECIFIED", "AUDIO_CONTENT_TYPE_UNKNOWN", @@ -10202,7 +10202,7 @@ "type": "string" }, "contentInstreamPosition": { - "description": "The content instream position for video or audio ads. Output only in v1. Required in v2.", + "description": "The content instream position for video or audio ads. Output only in v1.", "enum": [ "CONTENT_INSTREAM_POSITION_UNSPECIFIED", "CONTENT_INSTREAM_POSITION_PRE_ROLL", @@ -10274,7 +10274,7 @@ "type": "string" }, "contentOutstreamPosition": { - "description": "The content outstream position. Output only in v1. Required in v2.", + "description": "The content outstream position. Output only in v1.", "enum": [ "CONTENT_OUTSTREAM_POSITION_UNSPECIFIED", "CONTENT_OUTSTREAM_POSITION_UNKNOWN", @@ -11480,7 +11480,7 @@ "id": "DeviceTypeAssignedTargetingOptionDetails", "properties": { "deviceType": { - "description": "The display name of the device type. Output only in v1. Required in v2.", + "description": "The display name of the device type. Output only in v1.", "enum": [ "DEVICE_TYPE_UNSPECIFIED", "DEVICE_TYPE_COMPUTER", @@ -11996,7 +11996,7 @@ "id": "EnvironmentAssignedTargetingOptionDetails", "properties": { "environment": { - "description": "The serving environment. Output only in v1. Required in v2.", + "description": "The serving environment. Output only in v1.", "enum": [ "ENVIRONMENT_UNSPECIFIED", "ENVIRONMENT_WEB_OPTIMIZED", @@ -12886,7 +12886,7 @@ "id": "FrequencyCap", "properties": { "maxImpressions": { - "description": "The maximum number of times a user may be shown the same ad during this period. Must be greater than 0. Required when unlimited is `false` and max_views is not set.", + "description": "The maximum number of times a user may be shown the same ad during this period. Must be greater than 0. Required when unlimited is `false`.", "format": "int32", "type": "integer" }, @@ -12929,7 +12929,7 @@ "id": "GenderAssignedTargetingOptionDetails", "properties": { "gender": { - "description": "The gender of the audience. Output only in v1. Required in v2.", + "description": "The gender of the audience. Output only in v1.", "enum": [ "GENDER_UNSPECIFIED", "GENDER_MALE", @@ -15356,7 +15356,7 @@ "type": "string" }, "raiseBidForDeals": { - "description": "Controls whether the strategy takes deal floor prices into account.", + "description": "Whether the strategy takes deal floor prices into account.", "type": "boolean" } }, @@ -15453,7 +15453,7 @@ "id": "NativeContentPositionAssignedTargetingOptionDetails", "properties": { "contentPosition": { - "description": "The content position. Output only in v1. Required in v2.", + "description": "The content position. Output only in v1.", "enum": [ "NATIVE_CONTENT_POSITION_UNSPECIFIED", "NATIVE_CONTENT_POSITION_UNKNOWN", @@ -15627,7 +15627,7 @@ "id": "OmidAssignedTargetingOptionDetails", "properties": { "omid": { - "description": "The type of Open Measurement enabled inventory. Output only in v1. Required in v2.", + "description": "The type of Open Measurement enabled inventory. Output only in v1.", "enum": [ "OMID_UNSPECIFIED", "OMID_FOR_MOBILE_DISPLAY_ADS" @@ -16887,7 +16887,7 @@ "type": "string" }, "sensitiveCategory": { - "description": "An enum for the DV360 Sensitive category content classifier. Output only in v1. Required in v2.", + "description": "An enum for the DV360 Sensitive category content classifier. Output only in v1.", "enum": [ "SENSITIVE_CATEGORY_UNSPECIFIED", "SENSITIVE_CATEGORY_ADULT", @@ -17653,7 +17653,7 @@ "type": "string" }, "videoPlayerSize": { - "description": "The video player size. Output only in v1. Required in v2.", + "description": "The video player size. Output only in v1.", "enum": [ "VIDEO_PLAYER_SIZE_UNSPECIFIED", "VIDEO_PLAYER_SIZE_SMALL", @@ -17708,7 +17708,7 @@ "type": "string" }, "viewability": { - "description": "The predicted viewability percentage. Output only in v1. Required in v2.", + "description": "The predicted viewability percentage. Output only in v1.", "enum": [ "VIEWABILITY_UNSPECIFIED", "VIEWABILITY_10_PERCENT_OR_MORE", diff --git a/displayvideo/v1/displayvideo-gen.go b/displayvideo/v1/displayvideo-gen.go index 03736fd5106..6eaebfc2daf 100644 --- a/displayvideo/v1/displayvideo-gen.go +++ b/displayvideo/v1/displayvideo-gen.go @@ -1177,7 +1177,7 @@ type AgeRangeAssignedTargetingOptionDetails struct { // in this field can be 1) targeted solely, or, 2) part of a larger // continuous age range. The reach of a continuous age range targeting // can be expanded by also targeting an audience of an unknown age. - // Output only in v1. Required in v2. + // Output only in v1. // // Possible values: // "AGE_RANGE_UNSPECIFIED" - Default value when age range is not @@ -2194,8 +2194,7 @@ func (s *AudienceGroupAssignedTargetingOptionDetails) MarshalJSON() ([]byte, err // is not supported. Remove all audio content type targeting options to // achieve this effect. type AudioContentTypeAssignedTargetingOptionDetails struct { - // AudioContentType: The audio content type. Output only in v1. Required - // in v2. + // AudioContentType: The audio content type. Output only in v1. // // Possible values: // "AUDIO_CONTENT_TYPE_UNSPECIFIED" - Audio content type is not @@ -4586,7 +4585,7 @@ type ContentInstreamPositionAssignedTargetingOptionDetails struct { AdType string `json:"adType,omitempty"` // ContentInstreamPosition: The content instream position for video or - // audio ads. Output only in v1. Required in v2. + // audio ads. Output only in v1. // // Possible values: // "CONTENT_INSTREAM_POSITION_UNSPECIFIED" - Content instream position @@ -4700,7 +4699,7 @@ type ContentOutstreamPositionAssignedTargetingOptionDetails struct { AdType string `json:"adType,omitempty"` // ContentOutstreamPosition: The content outstream position. Output only - // in v1. Required in v2. + // in v1. // // Possible values: // "CONTENT_OUTSTREAM_POSITION_UNSPECIFIED" - Content outstream @@ -6439,7 +6438,6 @@ func (s *DeviceMakeModelTargetingOptionDetails) MarshalJSON() ([]byte, error) { // `TARGETING_TYPE_DEVICE_TYPE`. type DeviceTypeAssignedTargetingOptionDetails struct { // DeviceType: The display name of the device type. Output only in v1. - // Required in v2. // // Possible values: // "DEVICE_TYPE_UNSPECIFIED" - Default value when device type is not @@ -7126,8 +7124,7 @@ type Empty struct { // of an AssignedTargetingOption when targeting_type is // `TARGETING_TYPE_ENVIRONMENT`. type EnvironmentAssignedTargetingOptionDetails struct { - // Environment: The serving environment. Output only in v1. Required in - // v2. + // Environment: The serving environment. Output only in v1. // // Possible values: // "ENVIRONMENT_UNSPECIFIED" - Default value when environment is not @@ -8044,7 +8041,7 @@ func (s *FloodlightGroup) MarshalJSON() ([]byte, error) { type FrequencyCap struct { // MaxImpressions: The maximum number of times a user may be shown the // same ad during this period. Must be greater than 0. Required when - // unlimited is `false` and max_views is not set. + // unlimited is `false`. MaxImpressions int64 `json:"maxImpressions,omitempty"` // TimeUnit: The time unit in which the frequency cap will be applied. @@ -8110,8 +8107,7 @@ func (s *FrequencyCap) MarshalJSON() ([]byte, error) { // AssignedTargetingOption when targeting_type is // `TARTGETING_TYPE_GENDER`. type GenderAssignedTargetingOptionDetails struct { - // Gender: The gender of the audience. Output only in v1. Required in - // v2. + // Gender: The gender of the audience. Output only in v1. // // Possible values: // "GENDER_UNSPECIFIED" - Default value when gender is not specified @@ -11655,8 +11651,8 @@ type MaximizeSpendBidStrategy struct { // impressions. PerformanceGoalType string `json:"performanceGoalType,omitempty"` - // RaiseBidForDeals: Controls whether the strategy takes deal floor - // prices into account. + // RaiseBidForDeals: Whether the strategy takes deal floor prices into + // account. RaiseBidForDeals bool `json:"raiseBidForDeals,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -11842,8 +11838,7 @@ func (s *Money) MarshalJSON() ([]byte, error) { // Explicitly targeting all options is not supported. Remove all native // content position targeting options to achieve this effect. type NativeContentPositionAssignedTargetingOptionDetails struct { - // ContentPosition: The content position. Output only in v1. Required in - // v2. + // ContentPosition: The content position. Output only in v1. // // Possible values: // "NATIVE_CONTENT_POSITION_UNSPECIFIED" - Native content position is @@ -12142,7 +12137,7 @@ func (s *ObaIcon) MarshalJSON() ([]byte, error) { // `TARGETING_TYPE_OMID`. type OmidAssignedTargetingOptionDetails struct { // Omid: The type of Open Measurement enabled inventory. Output only in - // v1. Required in v2. + // v1. // // Possible values: // "OMID_UNSPECIFIED" - Default value when omid targeting is not @@ -14141,7 +14136,7 @@ type SensitiveCategoryAssignedTargetingOptionDetails struct { ExcludedTargetingOptionId string `json:"excludedTargetingOptionId,omitempty"` // SensitiveCategory: An enum for the DV360 Sensitive category content - // classifier. Output only in v1. Required in v2. + // classifier. Output only in v1. // // Possible values: // "SENSITIVE_CATEGORY_UNSPECIFIED" - This enum is only a placeholder @@ -15294,8 +15289,7 @@ type VideoPlayerSizeAssignedTargetingOptionDetails struct { // targeting_type is `TARGETING_TYPE_VIDEO_PLAYER_SIZE`. TargetingOptionId string `json:"targetingOptionId,omitempty"` - // VideoPlayerSize: The video player size. Output only in v1. Required - // in v2. + // VideoPlayerSize: The video player size. Output only in v1. // // Possible values: // "VIDEO_PLAYER_SIZE_UNSPECIFIED" - Video player size is not @@ -15396,7 +15390,6 @@ type ViewabilityAssignedTargetingOptionDetails struct { TargetingOptionId string `json:"targetingOptionId,omitempty"` // Viewability: The predicted viewability percentage. Output only in v1. - // Required in v2. // // Possible values: // "VIEWABILITY_UNSPECIFIED" - Default value when viewability is not @@ -24725,8 +24718,8 @@ func (c *AdvertisersLineItemsListCall) Filter(filter string) *AdvertisersLineIte } // OrderBy sets the optional parameter "orderBy": Field by which to sort -// the list. Acceptable values are: * "displayName" (default) * -// "entityStatus" * “flight.dateRange.endDate” * "updateTime" The +// the list. Acceptable values are: * `displayName` (default) * +// `entityStatus` * `flight.dateRange.endDate` * `updateTime` The // default sorting order is ascending. To specify descending order for a // field, a suffix "desc" should be added to the field name. Example: // `displayName desc`. @@ -24875,7 +24868,7 @@ func (c *AdvertisersLineItemsListCall) Do(opts ...googleapi.CallOption) (*ListLi // "type": "string" // }, // "orderBy": { - // "description": "Field by which to sort the list. Acceptable values are: * \"displayName\" (default) * \"entityStatus\" * “flight.dateRange.endDate” * \"updateTime\" The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `displayName desc`.", + // "description": "Field by which to sort the list. Acceptable values are: * `displayName` (default) * `entityStatus` * `flight.dateRange.endDate` * `updateTime` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `displayName desc`.", // "location": "query", // "type": "string" // }, diff --git a/documentai/v1/documentai-api.json b/documentai/v1/documentai-api.json index e588dce6b22..4a4beeb43fd 100644 --- a/documentai/v1/documentai-api.json +++ b/documentai/v1/documentai-api.json @@ -1029,7 +1029,7 @@ } } }, - "revision": "20220401", + "revision": "20220409", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3BatchDeleteDocumentsMetadata": { @@ -1174,6 +1174,17 @@ }, "type": "object" }, + "GoogleCloudDocumentaiUiv1beta3DeleteDataLabelingJobOperationMetadata": { + "description": "The long running operation metadata for DeleteDataLabelingJob.", + "id": "GoogleCloudDocumentaiUiv1beta3DeleteDataLabelingJobOperationMetadata", + "properties": { + "commonMetadata": { + "$ref": "GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata", + "description": "The basic metadata of the long running operation." + } + }, + "type": "object" + }, "GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata": { "description": "The long running operation metadata for DeleteLabelerPool.", "id": "GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata", @@ -3188,6 +3199,10 @@ "format": "google-datetime", "type": "string" }, + "deprecationInfo": { + "$ref": "GoogleCloudDocumentaiV1ProcessorVersionDeprecationInfo", + "description": "If set, information about the eventual deprecation of this version." + }, "displayName": { "description": "The display name of the processor version.", "type": "string" @@ -3235,6 +3250,22 @@ }, "type": "object" }, + "GoogleCloudDocumentaiV1ProcessorVersionDeprecationInfo": { + "description": "Information about the upcoming deprecation of this processor version.", + "id": "GoogleCloudDocumentaiV1ProcessorVersionDeprecationInfo", + "properties": { + "deprecationTime": { + "description": "The time at which this processor version will be deprecated.", + "format": "google-datetime", + "type": "string" + }, + "replacementProcessorVersion": { + "description": "If set, the processor version that will be used as a replacement.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDocumentaiV1RawDocument": { "description": "Payload message of raw document content (bytes).", "id": "GoogleCloudDocumentaiV1RawDocument", diff --git a/documentai/v1/documentai-gen.go b/documentai/v1/documentai-gen.go index 70ebb898587..572d93a6729 100644 --- a/documentai/v1/documentai-gen.go +++ b/documentai/v1/documentai-gen.go @@ -481,6 +481,36 @@ func (s *GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata) Marsh return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDocumentaiUiv1beta3DeleteDataLabelingJobOperationMetadata: +// The long running operation metadata for DeleteDataLabelingJob. +type GoogleCloudDocumentaiUiv1beta3DeleteDataLabelingJobOperationMetadata struct { + // CommonMetadata: The basic metadata of the long running operation. + CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CommonMetadata") 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. "CommonMetadata") 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 *GoogleCloudDocumentaiUiv1beta3DeleteDataLabelingJobOperationMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDocumentaiUiv1beta3DeleteDataLabelingJobOperationMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata: The // long running operation metadata for DeleteLabelerPool. type GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata struct { @@ -3972,6 +4002,10 @@ type GoogleCloudDocumentaiV1ProcessorVersion struct { // CreateTime: The time the processor version was created. CreateTime string `json:"createTime,omitempty"` + // DeprecationInfo: If set, information about the eventual deprecation + // of this version. + DeprecationInfo *GoogleCloudDocumentaiV1ProcessorVersionDeprecationInfo `json:"deprecationInfo,omitempty"` + // DisplayName: The display name of the processor version. DisplayName string `json:"displayName,omitempty"` @@ -4034,6 +4068,41 @@ func (s *GoogleCloudDocumentaiV1ProcessorVersion) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDocumentaiV1ProcessorVersionDeprecationInfo: Information +// about the upcoming deprecation of this processor version. +type GoogleCloudDocumentaiV1ProcessorVersionDeprecationInfo struct { + // DeprecationTime: The time at which this processor version will be + // deprecated. + DeprecationTime string `json:"deprecationTime,omitempty"` + + // ReplacementProcessorVersion: If set, the processor version that will + // be used as a replacement. + ReplacementProcessorVersion string `json:"replacementProcessorVersion,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DeprecationTime") 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. "DeprecationTime") 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 *GoogleCloudDocumentaiV1ProcessorVersionDeprecationInfo) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDocumentaiV1ProcessorVersionDeprecationInfo + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDocumentaiV1RawDocument: Payload message of raw document // content (bytes). type GoogleCloudDocumentaiV1RawDocument struct { diff --git a/documentai/v1beta2/documentai-api.json b/documentai/v1beta2/documentai-api.json index 026f76c6471..9f8cbf6ae01 100644 --- a/documentai/v1beta2/documentai-api.json +++ b/documentai/v1beta2/documentai-api.json @@ -292,7 +292,7 @@ } } }, - "revision": "20220326", + "revision": "20220409", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3BatchDeleteDocumentsMetadata": { @@ -437,6 +437,17 @@ }, "type": "object" }, + "GoogleCloudDocumentaiUiv1beta3DeleteDataLabelingJobOperationMetadata": { + "description": "The long running operation metadata for DeleteDataLabelingJob.", + "id": "GoogleCloudDocumentaiUiv1beta3DeleteDataLabelingJobOperationMetadata", + "properties": { + "commonMetadata": { + "$ref": "GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata", + "description": "The basic metadata of the long running operation." + } + }, + "type": "object" + }, "GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata": { "description": "The long running operation metadata for DeleteLabelerPool.", "id": "GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata", diff --git a/documentai/v1beta2/documentai-gen.go b/documentai/v1beta2/documentai-gen.go index 997cbc575d5..3840e04f285 100644 --- a/documentai/v1beta2/documentai-gen.go +++ b/documentai/v1beta2/documentai-gen.go @@ -409,6 +409,36 @@ func (s *GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata) Marsh return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDocumentaiUiv1beta3DeleteDataLabelingJobOperationMetadata: +// The long running operation metadata for DeleteDataLabelingJob. +type GoogleCloudDocumentaiUiv1beta3DeleteDataLabelingJobOperationMetadata struct { + // CommonMetadata: The basic metadata of the long running operation. + CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CommonMetadata") 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. "CommonMetadata") 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 *GoogleCloudDocumentaiUiv1beta3DeleteDataLabelingJobOperationMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDocumentaiUiv1beta3DeleteDataLabelingJobOperationMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata: The // long running operation metadata for DeleteLabelerPool. type GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata struct { diff --git a/documentai/v1beta3/documentai-api.json b/documentai/v1beta3/documentai-api.json index cb36e62ffb1..84f0b85611a 100644 --- a/documentai/v1beta3/documentai-api.json +++ b/documentai/v1beta3/documentai-api.json @@ -796,7 +796,7 @@ } } }, - "revision": "20220401", + "revision": "20220409", "rootUrl": "https://documentai.googleapis.com/", "schemas": { "GoogleCloudDocumentaiUiv1beta3BatchDeleteDocumentsMetadata": { @@ -941,6 +941,17 @@ }, "type": "object" }, + "GoogleCloudDocumentaiUiv1beta3DeleteDataLabelingJobOperationMetadata": { + "description": "The long running operation metadata for DeleteDataLabelingJob.", + "id": "GoogleCloudDocumentaiUiv1beta3DeleteDataLabelingJobOperationMetadata", + "properties": { + "commonMetadata": { + "$ref": "GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata", + "description": "The basic metadata of the long running operation." + } + }, + "type": "object" + }, "GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata": { "description": "The long running operation metadata for DeleteLabelerPool.", "id": "GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata", @@ -5762,6 +5773,10 @@ "format": "google-datetime", "type": "string" }, + "deprecationInfo": { + "$ref": "GoogleCloudDocumentaiV1beta3ProcessorVersionDeprecationInfo", + "description": "If set, information about the eventual deprecation of this version." + }, "displayName": { "description": "The display name of the processor version.", "type": "string" @@ -5809,6 +5824,22 @@ }, "type": "object" }, + "GoogleCloudDocumentaiV1beta3ProcessorVersionDeprecationInfo": { + "description": "Information about the upcoming deprecation of this processor version.", + "id": "GoogleCloudDocumentaiV1beta3ProcessorVersionDeprecationInfo", + "properties": { + "deprecationTime": { + "description": "The time at which this processor version will be deprecated.", + "format": "google-datetime", + "type": "string" + }, + "replacementProcessorVersion": { + "description": "If set, the processor version that will be used as a replacement.", + "type": "string" + } + }, + "type": "object" + }, "GoogleCloudDocumentaiV1beta3RawDocument": { "description": "Payload message of raw document content (bytes).", "id": "GoogleCloudDocumentaiV1beta3RawDocument", diff --git a/documentai/v1beta3/documentai-gen.go b/documentai/v1beta3/documentai-gen.go index aaa8b025066..5fd13ed2835 100644 --- a/documentai/v1beta3/documentai-gen.go +++ b/documentai/v1beta3/documentai-gen.go @@ -409,6 +409,36 @@ func (s *GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata) Marsh return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDocumentaiUiv1beta3DeleteDataLabelingJobOperationMetadata: +// The long running operation metadata for DeleteDataLabelingJob. +type GoogleCloudDocumentaiUiv1beta3DeleteDataLabelingJobOperationMetadata struct { + // CommonMetadata: The basic metadata of the long running operation. + CommonMetadata *GoogleCloudDocumentaiUiv1beta3CommonOperationMetadata `json:"commonMetadata,omitempty"` + + // ForceSendFields is a list of field names (e.g. "CommonMetadata") 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. "CommonMetadata") 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 *GoogleCloudDocumentaiUiv1beta3DeleteDataLabelingJobOperationMetadata) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDocumentaiUiv1beta3DeleteDataLabelingJobOperationMetadata + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata: The // long running operation metadata for DeleteLabelerPool. type GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata struct { @@ -8490,6 +8520,10 @@ type GoogleCloudDocumentaiV1beta3ProcessorVersion struct { // CreateTime: The time the processor version was created. CreateTime string `json:"createTime,omitempty"` + // DeprecationInfo: If set, information about the eventual deprecation + // of this version. + DeprecationInfo *GoogleCloudDocumentaiV1beta3ProcessorVersionDeprecationInfo `json:"deprecationInfo,omitempty"` + // DisplayName: The display name of the processor version. DisplayName string `json:"displayName,omitempty"` @@ -8552,6 +8586,41 @@ func (s *GoogleCloudDocumentaiV1beta3ProcessorVersion) MarshalJSON() ([]byte, er return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// GoogleCloudDocumentaiV1beta3ProcessorVersionDeprecationInfo: +// Information about the upcoming deprecation of this processor version. +type GoogleCloudDocumentaiV1beta3ProcessorVersionDeprecationInfo struct { + // DeprecationTime: The time at which this processor version will be + // deprecated. + DeprecationTime string `json:"deprecationTime,omitempty"` + + // ReplacementProcessorVersion: If set, the processor version that will + // be used as a replacement. + ReplacementProcessorVersion string `json:"replacementProcessorVersion,omitempty"` + + // ForceSendFields is a list of field names (e.g. "DeprecationTime") 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. "DeprecationTime") 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 *GoogleCloudDocumentaiV1beta3ProcessorVersionDeprecationInfo) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudDocumentaiV1beta3ProcessorVersionDeprecationInfo + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // GoogleCloudDocumentaiV1beta3RawDocument: Payload message of raw // document content (bytes). type GoogleCloudDocumentaiV1beta3RawDocument struct { diff --git a/firebaseappcheck/v1beta/firebaseappcheck-api.json b/firebaseappcheck/v1beta/firebaseappcheck-api.json index bd364decc75..9737bbf7e02 100644 --- a/firebaseappcheck/v1beta/firebaseappcheck-api.json +++ b/firebaseappcheck/v1beta/firebaseappcheck-api.json @@ -287,35 +287,6 @@ "https://www.googleapis.com/auth/firebase" ] }, - "exchangePlayIntegrityToken": { - "description": "Validates an [integrity verdict response token from Play Integrity](https://developer.android.com/google/play/integrity/verdict#decrypt-verify). If valid, returns an AppCheckToken.", - "flatPath": "v1beta/projects/{projectsId}/apps/{appsId}:exchangePlayIntegrityToken", - "httpMethod": "POST", - "id": "firebaseappcheck.projects.apps.exchangePlayIntegrityToken", - "parameterOrder": [ - "app" - ], - "parameters": { - "app": { - "description": "Required. The relative resource name of the Android app, in the format: ``` projects/{project_number}/apps/{app_id} ``` If necessary, the `project_number` element can be replaced with the project ID of the Firebase project. Learn more about using project identifiers in Google's [AIP 2510](https://google.aip.dev/cloud/2510) standard.", - "location": "path", - "pattern": "^projects/[^/]+/apps/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1beta/{+app}:exchangePlayIntegrityToken", - "request": { - "$ref": "GoogleFirebaseAppcheckV1betaExchangePlayIntegrityTokenRequest" - }, - "response": { - "$ref": "GoogleFirebaseAppcheckV1betaAppCheckToken" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/firebase" - ] - }, "exchangeRecaptchaEnterpriseToken": { "description": "Validates a [reCAPTCHA Enterprise response token](https://cloud.google.com/recaptcha-enterprise/docs/create-assessment#retrieve_token). If valid, returns an App Check token AppCheckToken.", "flatPath": "v1beta/projects/{projectsId}/apps/{appsId}:exchangeRecaptchaEnterpriseToken", @@ -460,35 +431,6 @@ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/firebase" ] - }, - "generatePlayIntegrityChallenge": { - "description": "Generates a challenge that protects the integrity of an immediately following integrity verdict request to the Play Integrity API. The next call to ExchangePlayIntegrityToken using the resulting integrity token will verify the presence and validity of the challenge. A challenge should not be reused for multiple calls.", - "flatPath": "v1beta/projects/{projectsId}/apps/{appsId}:generatePlayIntegrityChallenge", - "httpMethod": "POST", - "id": "firebaseappcheck.projects.apps.generatePlayIntegrityChallenge", - "parameterOrder": [ - "app" - ], - "parameters": { - "app": { - "description": "Required. The relative resource name of the app, in the format: ``` projects/{project_number}/apps/{app_id} ``` If necessary, the `project_number` element can be replaced with the project ID of the Firebase project. Learn more about using project identifiers in Google's [AIP 2510](https://google.aip.dev/cloud/2510) standard.", - "location": "path", - "pattern": "^projects/[^/]+/apps/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1beta/{+app}:generatePlayIntegrityChallenge", - "request": { - "$ref": "GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeRequest" - }, - "response": { - "$ref": "GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/firebase" - ] } }, "resources": { @@ -843,103 +785,6 @@ } } }, - "playIntegrityConfig": { - "methods": { - "batchGet": { - "description": "Atomically gets the PlayIntegrityConfigs for the specified list of apps.", - "flatPath": "v1beta/projects/{projectsId}/apps/-/playIntegrityConfig:batchGet", - "httpMethod": "GET", - "id": "firebaseappcheck.projects.apps.playIntegrityConfig.batchGet", - "parameterOrder": [ - "parent" - ], - "parameters": { - "names": { - "description": "Required. The relative resource names of the PlayIntegrityConfigs to retrieve, in the format ``` projects/{project_number}/apps/{app_id}/playIntegrityConfig ``` A maximum of 100 objects can be retrieved in a batch.", - "location": "query", - "repeated": true, - "type": "string" - }, - "parent": { - "description": "Required. The parent project name shared by all PlayIntegrityConfigs being retrieved, in the format ``` projects/{project_number} ``` The parent collection in the `name` field of any resource being retrieved must match this field, or the entire batch fails.", - "location": "path", - "pattern": "^projects/[^/]+$", - "required": true, - "type": "string" - } - }, - "path": "v1beta/{+parent}/apps/-/playIntegrityConfig:batchGet", - "response": { - "$ref": "GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/firebase" - ] - }, - "get": { - "description": "Gets the PlayIntegrityConfig for the specified app.", - "flatPath": "v1beta/projects/{projectsId}/apps/{appsId}/playIntegrityConfig", - "httpMethod": "GET", - "id": "firebaseappcheck.projects.apps.playIntegrityConfig.get", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Required. The relative resource name of the PlayIntegrityConfig, in the format: ``` projects/{project_number}/apps/{app_id}/playIntegrityConfig ```", - "location": "path", - "pattern": "^projects/[^/]+/apps/[^/]+/playIntegrityConfig$", - "required": true, - "type": "string" - } - }, - "path": "v1beta/{+name}", - "response": { - "$ref": "GoogleFirebaseAppcheckV1betaPlayIntegrityConfig" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/firebase" - ] - }, - "patch": { - "description": "Updates the PlayIntegrityConfig for the specified app. While this configuration is incomplete or invalid, the app will be unable to exchange Play Integrity tokens for App Check tokens.", - "flatPath": "v1beta/projects/{projectsId}/apps/{appsId}/playIntegrityConfig", - "httpMethod": "PATCH", - "id": "firebaseappcheck.projects.apps.playIntegrityConfig.patch", - "parameterOrder": [ - "name" - ], - "parameters": { - "name": { - "description": "Required. The relative resource name of the Play Integrity configuration object, in the format: ``` projects/{project_number}/apps/{app_id}/playIntegrityConfig ```", - "location": "path", - "pattern": "^projects/[^/]+/apps/[^/]+/playIntegrityConfig$", - "required": true, - "type": "string" - }, - "updateMask": { - "description": "Required. A comma-separated list of names of fields in the PlayIntegrityConfig Gets to update. Example: `token_ttl`.", - "format": "google-fieldmask", - "location": "query", - "type": "string" - } - }, - "path": "v1beta/{+name}", - "request": { - "$ref": "GoogleFirebaseAppcheckV1betaPlayIntegrityConfig" - }, - "response": { - "$ref": "GoogleFirebaseAppcheckV1betaPlayIntegrityConfig" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/firebase" - ] - } - } - }, "recaptchaConfig": { "methods": { "batchGet": { @@ -1464,7 +1309,7 @@ } } }, - "revision": "20220404", + "revision": "20220408", "rootUrl": "https://firebaseappcheck.googleapis.com/", "schemas": { "GoogleFirebaseAppcheckV1betaAppAttestConfig": { @@ -1547,20 +1392,6 @@ }, "type": "object" }, - "GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse": { - "description": "Response message for the BatchGetPlayIntegrityConfigs method.", - "id": "GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse", - "properties": { - "configs": { - "description": "PlayIntegrityConfigs retrieved.", - "items": { - "$ref": "GoogleFirebaseAppcheckV1betaPlayIntegrityConfig" - }, - "type": "array" - } - }, - "type": "object" - }, "GoogleFirebaseAppcheckV1betaBatchGetRecaptchaConfigsResponse": { "description": "Response message for the BatchGetRecaptchaConfigs method.", "id": "GoogleFirebaseAppcheckV1betaBatchGetRecaptchaConfigsResponse", @@ -1795,17 +1626,6 @@ }, "type": "object" }, - "GoogleFirebaseAppcheckV1betaExchangePlayIntegrityTokenRequest": { - "description": "Request message for the ExchangePlayIntegrityToken method.", - "id": "GoogleFirebaseAppcheckV1betaExchangePlayIntegrityTokenRequest", - "properties": { - "playIntegrityToken": { - "description": "Required. The [integrity verdict response token from Play Integrity](https://developer.android.com/google/play/integrity/verdict#decrypt-verify) issued to your app.", - "type": "string" - } - }, - "type": "object" - }, "GoogleFirebaseAppcheckV1betaExchangeRecaptchaEnterpriseTokenRequest": { "description": "Request message for the ExchangeRecaptchaEnterpriseToken method.", "id": "GoogleFirebaseAppcheckV1betaExchangeRecaptchaEnterpriseTokenRequest", @@ -1873,28 +1693,6 @@ }, "type": "object" }, - "GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeRequest": { - "description": "Request message for the GeneratePlayIntegrityChallenge method.", - "id": "GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeRequest", - "properties": {}, - "type": "object" - }, - "GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse": { - "description": "Response message for the GeneratePlayIntegrityChallenge method.", - "id": "GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse", - "properties": { - "challenge": { - "description": "A one-time use [challenge](https://developer.android.com/google/play/integrity/verdict#protect-against-replay-attacks) for the client to pass to the Play Integrity API.", - "type": "string" - }, - "ttl": { - "description": "The duration from the time this challenge is minted until its expiration. This field is intended to ease client-side token management, since the client may have clock skew, but is still able to accurately measure a duration.", - "format": "google-duration", - "type": "string" - } - }, - "type": "object" - }, "GoogleFirebaseAppcheckV1betaListDebugTokensResponse": { "description": "Response message for the ListDebugTokens method.", "id": "GoogleFirebaseAppcheckV1betaListDebugTokensResponse", @@ -1931,22 +1729,6 @@ }, "type": "object" }, - "GoogleFirebaseAppcheckV1betaPlayIntegrityConfig": { - "description": "An app's Play Integrity configuration object. This configuration controls certain properties of the App Check token returned by ExchangePlayIntegrityToken, such as its ttl. Note that your registered SHA-256 certificate fingerprints are used to validate tokens issued by the Play Integrity API; please register them via the Firebase Console or programmatically via the [Firebase Management Service](https://firebase.google.com/docs/projects/api/reference/rest/v1beta1/projects.androidApps.sha/create).", - "id": "GoogleFirebaseAppcheckV1betaPlayIntegrityConfig", - "properties": { - "name": { - "description": "Required. The relative resource name of the Play Integrity configuration object, in the format: ``` projects/{project_number}/apps/{app_id}/playIntegrityConfig ```", - "type": "string" - }, - "tokenTtl": { - "description": "Specifies the duration for which App Check tokens exchanged from Play Integrity tokens will be valid. If unset, a default value of 1 hour is assumed. Must be between 30 minutes and 7 days, inclusive.", - "format": "google-duration", - "type": "string" - } - }, - "type": "object" - }, "GoogleFirebaseAppcheckV1betaPublicJwk": { "description": "A JWK as specified by [section 4 of RFC 7517](https://tools.ietf.org/html/rfc7517#section-4) and [section 6.3.1 of RFC 7518](https://tools.ietf.org/html/rfc7518#section-6.3.1).", "id": "GoogleFirebaseAppcheckV1betaPublicJwk", diff --git a/firebaseappcheck/v1beta/firebaseappcheck-gen.go b/firebaseappcheck/v1beta/firebaseappcheck-gen.go index e0bd32b6a73..fed7ffcb2af 100644 --- a/firebaseappcheck/v1beta/firebaseappcheck-gen.go +++ b/firebaseappcheck/v1beta/firebaseappcheck-gen.go @@ -177,7 +177,6 @@ func NewProjectsAppsService(s *Service) *ProjectsAppsService { rs.AppAttestConfig = NewProjectsAppsAppAttestConfigService(s) rs.DebugTokens = NewProjectsAppsDebugTokensService(s) rs.DeviceCheckConfig = NewProjectsAppsDeviceCheckConfigService(s) - rs.PlayIntegrityConfig = NewProjectsAppsPlayIntegrityConfigService(s) rs.RecaptchaConfig = NewProjectsAppsRecaptchaConfigService(s) rs.RecaptchaEnterpriseConfig = NewProjectsAppsRecaptchaEnterpriseConfigService(s) rs.RecaptchaV3Config = NewProjectsAppsRecaptchaV3ConfigService(s) @@ -194,8 +193,6 @@ type ProjectsAppsService struct { DeviceCheckConfig *ProjectsAppsDeviceCheckConfigService - PlayIntegrityConfig *ProjectsAppsPlayIntegrityConfigService - RecaptchaConfig *ProjectsAppsRecaptchaConfigService RecaptchaEnterpriseConfig *ProjectsAppsRecaptchaEnterpriseConfigService @@ -232,15 +229,6 @@ type ProjectsAppsDeviceCheckConfigService struct { s *Service } -func NewProjectsAppsPlayIntegrityConfigService(s *Service) *ProjectsAppsPlayIntegrityConfigService { - rs := &ProjectsAppsPlayIntegrityConfigService{s: s} - return rs -} - -type ProjectsAppsPlayIntegrityConfigService struct { - s *Service -} - func NewProjectsAppsRecaptchaConfigService(s *Service) *ProjectsAppsRecaptchaConfigService { rs := &ProjectsAppsRecaptchaConfigService{s: s} return rs @@ -488,39 +476,6 @@ func (s *GoogleFirebaseAppcheckV1betaBatchGetDeviceCheckConfigsResponse) Marshal return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse: -// Response message for the BatchGetPlayIntegrityConfigs method. -type GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse struct { - // Configs: PlayIntegrityConfigs retrieved. - Configs []*GoogleFirebaseAppcheckV1betaPlayIntegrityConfig `json:"configs,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the - // server. - googleapi.ServerResponse `json:"-"` - - // ForceSendFields is a list of field names (e.g. "Configs") 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. "Configs") 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 *GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // GoogleFirebaseAppcheckV1betaBatchGetRecaptchaConfigsResponse: // Response message for the BatchGetRecaptchaConfigs method. type GoogleFirebaseAppcheckV1betaBatchGetRecaptchaConfigsResponse struct { @@ -1046,39 +1001,6 @@ func (s *GoogleFirebaseAppcheckV1betaExchangeDeviceCheckTokenRequest) MarshalJSO return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleFirebaseAppcheckV1betaExchangePlayIntegrityTokenRequest: -// Request message for the ExchangePlayIntegrityToken method. -type GoogleFirebaseAppcheckV1betaExchangePlayIntegrityTokenRequest struct { - // PlayIntegrityToken: Required. The integrity verdict response token - // from Play Integrity - // (https://developer.android.com/google/play/integrity/verdict#decrypt-verify) - // issued to your app. - PlayIntegrityToken string `json:"playIntegrityToken,omitempty"` - - // ForceSendFields is a list of field names (e.g. "PlayIntegrityToken") - // 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. "PlayIntegrityToken") 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 *GoogleFirebaseAppcheckV1betaExchangePlayIntegrityTokenRequest) MarshalJSON() ([]byte, error) { - type NoMethod GoogleFirebaseAppcheckV1betaExchangePlayIntegrityTokenRequest - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // GoogleFirebaseAppcheckV1betaExchangeRecaptchaEnterpriseTokenRequest: // Request message for the ExchangeRecaptchaEnterpriseToken method. type GoogleFirebaseAppcheckV1betaExchangeRecaptchaEnterpriseTokenRequest struct { @@ -1253,52 +1175,6 @@ func (s *GoogleFirebaseAppcheckV1betaGenerateAppAttestChallengeResponse) Marshal return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeRequest: -// Request message for the GeneratePlayIntegrityChallenge method. -type GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeRequest struct { -} - -// GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse: -// Response message for the GeneratePlayIntegrityChallenge method. -type GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse struct { - // Challenge: A one-time use challenge - // (https://developer.android.com/google/play/integrity/verdict#protect-against-replay-attacks) - // for the client to pass to the Play Integrity API. - Challenge string `json:"challenge,omitempty"` - - // Ttl: The duration from the time this challenge is minted until its - // expiration. This field is intended to ease client-side token - // management, since the client may have clock skew, but is still able - // to accurately measure a duration. - Ttl string `json:"ttl,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the - // server. - googleapi.ServerResponse `json:"-"` - - // ForceSendFields is a list of field names (e.g. "Challenge") 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. "Challenge") 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 *GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse) MarshalJSON() ([]byte, error) { - type NoMethod GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // GoogleFirebaseAppcheckV1betaListDebugTokensResponse: Response message // for the ListDebugTokens method. type GoogleFirebaseAppcheckV1betaListDebugTokensResponse struct { @@ -1381,54 +1257,6 @@ func (s *GoogleFirebaseAppcheckV1betaListServicesResponse) MarshalJSON() ([]byte return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleFirebaseAppcheckV1betaPlayIntegrityConfig: An app's Play -// Integrity configuration object. This configuration controls certain -// properties of the App Check token returned by -// ExchangePlayIntegrityToken, such as its ttl. Note that your -// registered SHA-256 certificate fingerprints are used to validate -// tokens issued by the Play Integrity API; please register them via the -// Firebase Console or programmatically via the Firebase Management -// Service -// (https://firebase.google.com/docs/projects/api/reference/rest/v1beta1/projects.androidApps.sha/create). -type GoogleFirebaseAppcheckV1betaPlayIntegrityConfig struct { - // Name: Required. The relative resource name of the Play Integrity - // configuration object, in the format: ``` - // projects/{project_number}/apps/{app_id}/playIntegrityConfig ``` - Name string `json:"name,omitempty"` - - // TokenTtl: Specifies the duration for which App Check tokens exchanged - // from Play Integrity tokens will be valid. If unset, a default value - // of 1 hour is assumed. Must be between 30 minutes and 7 days, - // inclusive. - TokenTtl string `json:"tokenTtl,omitempty"` - - // ServerResponse contains the HTTP response code and headers from the - // server. - googleapi.ServerResponse `json:"-"` - - // ForceSendFields is a list of field names (e.g. "Name") to - // unconditionally include in API requests. By default, fields with - // empty or default values are omitted from API requests. 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. "Name") 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 *GoogleFirebaseAppcheckV1betaPlayIntegrityConfig) MarshalJSON() ([]byte, error) { - type NoMethod GoogleFirebaseAppcheckV1betaPlayIntegrityConfig - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // GoogleFirebaseAppcheckV1betaPublicJwk: A JWK as specified by section // 4 of RFC 7517 (https://tools.ietf.org/html/rfc7517#section-4) and // section 6.3.1 of RFC 7518 @@ -2764,158 +2592,6 @@ func (c *ProjectsAppsExchangeDeviceCheckTokenCall) Do(opts ...googleapi.CallOpti } -// method id "firebaseappcheck.projects.apps.exchangePlayIntegrityToken": - -type ProjectsAppsExchangePlayIntegrityTokenCall struct { - s *Service - appid string - googlefirebaseappcheckv1betaexchangeplayintegritytokenrequest *GoogleFirebaseAppcheckV1betaExchangePlayIntegrityTokenRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// ExchangePlayIntegrityToken: Validates an integrity verdict response -// token from Play Integrity -// (https://developer.android.com/google/play/integrity/verdict#decrypt-verify). -// If valid, returns an AppCheckToken. -// -// - app: The relative resource name of the Android app, in the format: -// ``` projects/{project_number}/apps/{app_id} ``` If necessary, the -// `project_number` element can be replaced with the project ID of the -// Firebase project. Learn more about using project identifiers in -// Google's AIP 2510 (https://google.aip.dev/cloud/2510) standard. -func (r *ProjectsAppsService) ExchangePlayIntegrityToken(appid string, googlefirebaseappcheckv1betaexchangeplayintegritytokenrequest *GoogleFirebaseAppcheckV1betaExchangePlayIntegrityTokenRequest) *ProjectsAppsExchangePlayIntegrityTokenCall { - c := &ProjectsAppsExchangePlayIntegrityTokenCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.appid = appid - c.googlefirebaseappcheckv1betaexchangeplayintegritytokenrequest = googlefirebaseappcheckv1betaexchangeplayintegritytokenrequest - 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 *ProjectsAppsExchangePlayIntegrityTokenCall) Fields(s ...googleapi.Field) *ProjectsAppsExchangePlayIntegrityTokenCall { - 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 *ProjectsAppsExchangePlayIntegrityTokenCall) Context(ctx context.Context) *ProjectsAppsExchangePlayIntegrityTokenCall { - 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 *ProjectsAppsExchangePlayIntegrityTokenCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsAppsExchangePlayIntegrityTokenCall) 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.googlefirebaseappcheckv1betaexchangeplayintegritytokenrequest) - 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, "v1beta/{+app}:exchangePlayIntegrityToken") - 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{ - "app": c.appid, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "firebaseappcheck.projects.apps.exchangePlayIntegrityToken" call. -// Exactly one of *GoogleFirebaseAppcheckV1betaAppCheckToken or error -// will be non-nil. Any non-2xx status code is an error. Response -// headers are in either -// *GoogleFirebaseAppcheckV1betaAppCheckToken.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 *ProjectsAppsExchangePlayIntegrityTokenCall) Do(opts ...googleapi.CallOption) (*GoogleFirebaseAppcheckV1betaAppCheckToken, 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 := &GoogleFirebaseAppcheckV1betaAppCheckToken{ - 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": "Validates an [integrity verdict response token from Play Integrity](https://developer.android.com/google/play/integrity/verdict#decrypt-verify). If valid, returns an AppCheckToken.", - // "flatPath": "v1beta/projects/{projectsId}/apps/{appsId}:exchangePlayIntegrityToken", - // "httpMethod": "POST", - // "id": "firebaseappcheck.projects.apps.exchangePlayIntegrityToken", - // "parameterOrder": [ - // "app" - // ], - // "parameters": { - // "app": { - // "description": "Required. The relative resource name of the Android app, in the format: ``` projects/{project_number}/apps/{app_id} ``` If necessary, the `project_number` element can be replaced with the project ID of the Firebase project. Learn more about using project identifiers in Google's [AIP 2510](https://google.aip.dev/cloud/2510) standard.", - // "location": "path", - // "pattern": "^projects/[^/]+/apps/[^/]+$", - // "required": true, - // "type": "string" - // } - // }, - // "path": "v1beta/{+app}:exchangePlayIntegrityToken", - // "request": { - // "$ref": "GoogleFirebaseAppcheckV1betaExchangePlayIntegrityTokenRequest" - // }, - // "response": { - // "$ref": "GoogleFirebaseAppcheckV1betaAppCheckToken" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform", - // "https://www.googleapis.com/auth/firebase" - // ] - // } - -} - // method id "firebaseappcheck.projects.apps.exchangeRecaptchaEnterpriseToken": type ProjectsAppsExchangeRecaptchaEnterpriseTokenCall struct { @@ -3674,162 +3350,7 @@ func (c *ProjectsAppsGenerateAppAttestChallengeCall) Do(opts ...googleapi.CallOp } -// method id "firebaseappcheck.projects.apps.generatePlayIntegrityChallenge": - -type ProjectsAppsGeneratePlayIntegrityChallengeCall struct { - s *Service - appid string - googlefirebaseappcheckv1betagenerateplayintegritychallengerequest *GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// GeneratePlayIntegrityChallenge: Generates a challenge that protects -// the integrity of an immediately following integrity verdict request -// to the Play Integrity API. The next call to -// ExchangePlayIntegrityToken using the resulting integrity token will -// verify the presence and validity of the challenge. A challenge should -// not be reused for multiple calls. -// -// - app: The relative resource name of the app, in the format: ``` -// projects/{project_number}/apps/{app_id} ``` If necessary, the -// `project_number` element can be replaced with the project ID of the -// Firebase project. Learn more about using project identifiers in -// Google's AIP 2510 (https://google.aip.dev/cloud/2510) standard. -func (r *ProjectsAppsService) GeneratePlayIntegrityChallenge(appid string, googlefirebaseappcheckv1betagenerateplayintegritychallengerequest *GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeRequest) *ProjectsAppsGeneratePlayIntegrityChallengeCall { - c := &ProjectsAppsGeneratePlayIntegrityChallengeCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.appid = appid - c.googlefirebaseappcheckv1betagenerateplayintegritychallengerequest = googlefirebaseappcheckv1betagenerateplayintegritychallengerequest - 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 *ProjectsAppsGeneratePlayIntegrityChallengeCall) Fields(s ...googleapi.Field) *ProjectsAppsGeneratePlayIntegrityChallengeCall { - 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 *ProjectsAppsGeneratePlayIntegrityChallengeCall) Context(ctx context.Context) *ProjectsAppsGeneratePlayIntegrityChallengeCall { - 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 *ProjectsAppsGeneratePlayIntegrityChallengeCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsAppsGeneratePlayIntegrityChallengeCall) 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.googlefirebaseappcheckv1betagenerateplayintegritychallengerequest) - 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, "v1beta/{+app}:generatePlayIntegrityChallenge") - 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{ - "app": c.appid, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "firebaseappcheck.projects.apps.generatePlayIntegrityChallenge" call. -// Exactly one of -// *GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse -// or error will be non-nil. Any non-2xx status code is an error. -// Response headers are in either -// *GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse.Se -// rverResponse.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 *ProjectsAppsGeneratePlayIntegrityChallengeCall) Do(opts ...googleapi.CallOption) (*GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse, 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 := &GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse{ - 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": "Generates a challenge that protects the integrity of an immediately following integrity verdict request to the Play Integrity API. The next call to ExchangePlayIntegrityToken using the resulting integrity token will verify the presence and validity of the challenge. A challenge should not be reused for multiple calls.", - // "flatPath": "v1beta/projects/{projectsId}/apps/{appsId}:generatePlayIntegrityChallenge", - // "httpMethod": "POST", - // "id": "firebaseappcheck.projects.apps.generatePlayIntegrityChallenge", - // "parameterOrder": [ - // "app" - // ], - // "parameters": { - // "app": { - // "description": "Required. The relative resource name of the app, in the format: ``` projects/{project_number}/apps/{app_id} ``` If necessary, the `project_number` element can be replaced with the project ID of the Firebase project. Learn more about using project identifiers in Google's [AIP 2510](https://google.aip.dev/cloud/2510) standard.", - // "location": "path", - // "pattern": "^projects/[^/]+/apps/[^/]+$", - // "required": true, - // "type": "string" - // } - // }, - // "path": "v1beta/{+app}:generatePlayIntegrityChallenge", - // "request": { - // "$ref": "GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeRequest" - // }, - // "response": { - // "$ref": "GoogleFirebaseAppcheckV1betaGeneratePlayIntegrityChallengeResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform", - // "https://www.googleapis.com/auth/firebase" - // ] - // } - -} - -// method id "firebaseappcheck.projects.apps.appAttestConfig.batchGet": +// method id "firebaseappcheck.projects.apps.appAttestConfig.batchGet": type ProjectsAppsAppAttestConfigBatchGetCall struct { s *Service @@ -5607,489 +5128,6 @@ func (c *ProjectsAppsDeviceCheckConfigPatchCall) Do(opts ...googleapi.CallOption } -// method id "firebaseappcheck.projects.apps.playIntegrityConfig.batchGet": - -type ProjectsAppsPlayIntegrityConfigBatchGetCall struct { - s *Service - parent string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// BatchGet: Atomically gets the PlayIntegrityConfigs for the specified -// list of apps. -// -// - parent: The parent project name shared by all PlayIntegrityConfigs -// being retrieved, in the format ``` projects/{project_number} ``` -// The parent collection in the `name` field of any resource being -// retrieved must match this field, or the entire batch fails. -func (r *ProjectsAppsPlayIntegrityConfigService) BatchGet(parent string) *ProjectsAppsPlayIntegrityConfigBatchGetCall { - c := &ProjectsAppsPlayIntegrityConfigBatchGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.parent = parent - return c -} - -// Names sets the optional parameter "names": Required. The relative -// resource names of the PlayIntegrityConfigs to retrieve, in the format -// ``` projects/{project_number}/apps/{app_id}/playIntegrityConfig ``` A -// maximum of 100 objects can be retrieved in a batch. -func (c *ProjectsAppsPlayIntegrityConfigBatchGetCall) Names(names ...string) *ProjectsAppsPlayIntegrityConfigBatchGetCall { - c.urlParams_.SetMulti("names", append([]string{}, names...)) - 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 *ProjectsAppsPlayIntegrityConfigBatchGetCall) Fields(s ...googleapi.Field) *ProjectsAppsPlayIntegrityConfigBatchGetCall { - 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 *ProjectsAppsPlayIntegrityConfigBatchGetCall) IfNoneMatch(entityTag string) *ProjectsAppsPlayIntegrityConfigBatchGetCall { - 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 *ProjectsAppsPlayIntegrityConfigBatchGetCall) Context(ctx context.Context) *ProjectsAppsPlayIntegrityConfigBatchGetCall { - 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 *ProjectsAppsPlayIntegrityConfigBatchGetCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsAppsPlayIntegrityConfigBatchGetCall) 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, "v1beta/{+parent}/apps/-/playIntegrityConfig:batchGet") - 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 "firebaseappcheck.projects.apps.playIntegrityConfig.batchGet" call. -// Exactly one of -// *GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse or -// error will be non-nil. Any non-2xx status code is an error. Response -// headers are in either -// *GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse.Serv -// erResponse.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 *ProjectsAppsPlayIntegrityConfigBatchGetCall) Do(opts ...googleapi.CallOption) (*GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse, 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 := &GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse{ - 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": "Atomically gets the PlayIntegrityConfigs for the specified list of apps.", - // "flatPath": "v1beta/projects/{projectsId}/apps/-/playIntegrityConfig:batchGet", - // "httpMethod": "GET", - // "id": "firebaseappcheck.projects.apps.playIntegrityConfig.batchGet", - // "parameterOrder": [ - // "parent" - // ], - // "parameters": { - // "names": { - // "description": "Required. The relative resource names of the PlayIntegrityConfigs to retrieve, in the format ``` projects/{project_number}/apps/{app_id}/playIntegrityConfig ``` A maximum of 100 objects can be retrieved in a batch.", - // "location": "query", - // "repeated": true, - // "type": "string" - // }, - // "parent": { - // "description": "Required. The parent project name shared by all PlayIntegrityConfigs being retrieved, in the format ``` projects/{project_number} ``` The parent collection in the `name` field of any resource being retrieved must match this field, or the entire batch fails.", - // "location": "path", - // "pattern": "^projects/[^/]+$", - // "required": true, - // "type": "string" - // } - // }, - // "path": "v1beta/{+parent}/apps/-/playIntegrityConfig:batchGet", - // "response": { - // "$ref": "GoogleFirebaseAppcheckV1betaBatchGetPlayIntegrityConfigsResponse" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform", - // "https://www.googleapis.com/auth/firebase" - // ] - // } - -} - -// method id "firebaseappcheck.projects.apps.playIntegrityConfig.get": - -type ProjectsAppsPlayIntegrityConfigGetCall struct { - s *Service - name string - urlParams_ gensupport.URLParams - ifNoneMatch_ string - ctx_ context.Context - header_ http.Header -} - -// Get: Gets the PlayIntegrityConfig for the specified app. -// -// - name: The relative resource name of the PlayIntegrityConfig, in the -// format: ``` -// projects/{project_number}/apps/{app_id}/playIntegrityConfig ```. -func (r *ProjectsAppsPlayIntegrityConfigService) Get(name string) *ProjectsAppsPlayIntegrityConfigGetCall { - c := &ProjectsAppsPlayIntegrityConfigGetCall{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 *ProjectsAppsPlayIntegrityConfigGetCall) Fields(s ...googleapi.Field) *ProjectsAppsPlayIntegrityConfigGetCall { - 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 *ProjectsAppsPlayIntegrityConfigGetCall) IfNoneMatch(entityTag string) *ProjectsAppsPlayIntegrityConfigGetCall { - 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 *ProjectsAppsPlayIntegrityConfigGetCall) Context(ctx context.Context) *ProjectsAppsPlayIntegrityConfigGetCall { - 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 *ProjectsAppsPlayIntegrityConfigGetCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsAppsPlayIntegrityConfigGetCall) 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, "v1beta/{+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 "firebaseappcheck.projects.apps.playIntegrityConfig.get" call. -// Exactly one of *GoogleFirebaseAppcheckV1betaPlayIntegrityConfig or -// error will be non-nil. Any non-2xx status code is an error. Response -// headers are in either -// *GoogleFirebaseAppcheckV1betaPlayIntegrityConfig.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 *ProjectsAppsPlayIntegrityConfigGetCall) Do(opts ...googleapi.CallOption) (*GoogleFirebaseAppcheckV1betaPlayIntegrityConfig, 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 := &GoogleFirebaseAppcheckV1betaPlayIntegrityConfig{ - 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 PlayIntegrityConfig for the specified app.", - // "flatPath": "v1beta/projects/{projectsId}/apps/{appsId}/playIntegrityConfig", - // "httpMethod": "GET", - // "id": "firebaseappcheck.projects.apps.playIntegrityConfig.get", - // "parameterOrder": [ - // "name" - // ], - // "parameters": { - // "name": { - // "description": "Required. The relative resource name of the PlayIntegrityConfig, in the format: ``` projects/{project_number}/apps/{app_id}/playIntegrityConfig ```", - // "location": "path", - // "pattern": "^projects/[^/]+/apps/[^/]+/playIntegrityConfig$", - // "required": true, - // "type": "string" - // } - // }, - // "path": "v1beta/{+name}", - // "response": { - // "$ref": "GoogleFirebaseAppcheckV1betaPlayIntegrityConfig" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform", - // "https://www.googleapis.com/auth/firebase" - // ] - // } - -} - -// method id "firebaseappcheck.projects.apps.playIntegrityConfig.patch": - -type ProjectsAppsPlayIntegrityConfigPatchCall struct { - s *Service - name string - googlefirebaseappcheckv1betaplayintegrityconfig *GoogleFirebaseAppcheckV1betaPlayIntegrityConfig - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header -} - -// Patch: Updates the PlayIntegrityConfig for the specified app. While -// this configuration is incomplete or invalid, the app will be unable -// to exchange Play Integrity tokens for App Check tokens. -// -// - name: The relative resource name of the Play Integrity -// configuration object, in the format: ``` -// projects/{project_number}/apps/{app_id}/playIntegrityConfig ```. -func (r *ProjectsAppsPlayIntegrityConfigService) Patch(name string, googlefirebaseappcheckv1betaplayintegrityconfig *GoogleFirebaseAppcheckV1betaPlayIntegrityConfig) *ProjectsAppsPlayIntegrityConfigPatchCall { - c := &ProjectsAppsPlayIntegrityConfigPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.googlefirebaseappcheckv1betaplayintegrityconfig = googlefirebaseappcheckv1betaplayintegrityconfig - return c -} - -// UpdateMask sets the optional parameter "updateMask": Required. A -// comma-separated list of names of fields in the PlayIntegrityConfig -// Gets to update. Example: `token_ttl`. -func (c *ProjectsAppsPlayIntegrityConfigPatchCall) UpdateMask(updateMask string) *ProjectsAppsPlayIntegrityConfigPatchCall { - c.urlParams_.Set("updateMask", updateMask) - return c -} - -// Fields allows partial responses to be retrieved. See -// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse -// for more information. -func (c *ProjectsAppsPlayIntegrityConfigPatchCall) Fields(s ...googleapi.Field) *ProjectsAppsPlayIntegrityConfigPatchCall { - 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 *ProjectsAppsPlayIntegrityConfigPatchCall) Context(ctx context.Context) *ProjectsAppsPlayIntegrityConfigPatchCall { - 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 *ProjectsAppsPlayIntegrityConfigPatchCall) Header() http.Header { - if c.header_ == nil { - c.header_ = make(http.Header) - } - return c.header_ -} - -func (c *ProjectsAppsPlayIntegrityConfigPatchCall) 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.googlefirebaseappcheckv1betaplayintegrityconfig) - 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, "v1beta/{+name}") - urls += "?" + c.urlParams_.Encode() - req, err := http.NewRequest("PATCH", urls, body) - if err != nil { - return nil, err - } - req.Header = reqHeaders - googleapi.Expand(req.URL, map[string]string{ - "name": c.name, - }) - return gensupport.SendRequest(c.ctx_, c.s.client, req) -} - -// Do executes the "firebaseappcheck.projects.apps.playIntegrityConfig.patch" call. -// Exactly one of *GoogleFirebaseAppcheckV1betaPlayIntegrityConfig or -// error will be non-nil. Any non-2xx status code is an error. Response -// headers are in either -// *GoogleFirebaseAppcheckV1betaPlayIntegrityConfig.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 *ProjectsAppsPlayIntegrityConfigPatchCall) Do(opts ...googleapi.CallOption) (*GoogleFirebaseAppcheckV1betaPlayIntegrityConfig, 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 := &GoogleFirebaseAppcheckV1betaPlayIntegrityConfig{ - 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 PlayIntegrityConfig for the specified app. While this configuration is incomplete or invalid, the app will be unable to exchange Play Integrity tokens for App Check tokens.", - // "flatPath": "v1beta/projects/{projectsId}/apps/{appsId}/playIntegrityConfig", - // "httpMethod": "PATCH", - // "id": "firebaseappcheck.projects.apps.playIntegrityConfig.patch", - // "parameterOrder": [ - // "name" - // ], - // "parameters": { - // "name": { - // "description": "Required. The relative resource name of the Play Integrity configuration object, in the format: ``` projects/{project_number}/apps/{app_id}/playIntegrityConfig ```", - // "location": "path", - // "pattern": "^projects/[^/]+/apps/[^/]+/playIntegrityConfig$", - // "required": true, - // "type": "string" - // }, - // "updateMask": { - // "description": "Required. A comma-separated list of names of fields in the PlayIntegrityConfig Gets to update. Example: `token_ttl`.", - // "format": "google-fieldmask", - // "location": "query", - // "type": "string" - // } - // }, - // "path": "v1beta/{+name}", - // "request": { - // "$ref": "GoogleFirebaseAppcheckV1betaPlayIntegrityConfig" - // }, - // "response": { - // "$ref": "GoogleFirebaseAppcheckV1betaPlayIntegrityConfig" - // }, - // "scopes": [ - // "https://www.googleapis.com/auth/cloud-platform", - // "https://www.googleapis.com/auth/firebase" - // ] - // } - -} - // method id "firebaseappcheck.projects.apps.recaptchaConfig.batchGet": type ProjectsAppsRecaptchaConfigBatchGetCall struct { diff --git a/gkebackup/v1/gkebackup-api.json b/gkebackup/v1/gkebackup-api.json index d65d22ed1df..17ba7557b80 100644 --- a/gkebackup/v1/gkebackup-api.json +++ b/gkebackup/v1/gkebackup-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" }, @@ -1688,7 +1688,7 @@ } } }, - "revision": "20220321", + "revision": "20220406", "rootUrl": "https://gkebackup.googleapis.com/", "schemas": { "AuditConfig": { @@ -2019,7 +2019,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" }, @@ -2804,7 +2804,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\"`", @@ -2852,7 +2852,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/gkebackup/v1/gkebackup-gen.go b/gkebackup/v1/gkebackup-gen.go index e5732546941..7b912df6293 100644 --- a/gkebackup/v1/gkebackup-gen.go +++ b/gkebackup/v1/gkebackup-gen.go @@ -673,8 +673,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 @@ -2092,7 +2092,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"` @@ -2199,7 +2199,7 @@ func (s *SubstitutionRule) 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"` @@ -2792,8 +2792,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 @@ -2922,7 +2922,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/iap/v1/iap-api.json b/iap/v1/iap-api.json index d37dc1d8a39..3cbf02d8ac1 100644 --- a/iap/v1/iap-api.json +++ b/iap/v1/iap-api.json @@ -652,7 +652,7 @@ } } }, - "revision": "20220318", + "revision": "20220408", "rootUrl": "https://iap.googleapis.com/", "schemas": { "AccessDeniedPageSettings": { @@ -725,7 +725,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" }, @@ -1101,7 +1101,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." } }, "type": "object" @@ -1111,7 +1111,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/iap/v1/iap-gen.go b/iap/v1/iap-gen.go index 0f6a26276a8..cebd0d6d87f 100644 --- a/iap/v1/iap-gen.go +++ b/iap/v1/iap-gen.go @@ -349,8 +349,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 @@ -1253,7 +1253,7 @@ func (s *Resource) 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"` @@ -1284,7 +1284,7 @@ func (s *SetIamPolicyRequest) 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"` diff --git a/iap/v1beta1/iap-api.json b/iap/v1beta1/iap-api.json index a3f1116aec2..1ab50b2db04 100644 --- a/iap/v1beta1/iap-api.json +++ b/iap/v1beta1/iap-api.json @@ -194,7 +194,7 @@ } } }, - "revision": "20211105", + "revision": "20220408", "rootUrl": "https://iap.googleapis.com/", "schemas": { "Binding": { @@ -206,7 +206,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" }, @@ -295,7 +295,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." } }, "type": "object" @@ -305,7 +305,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/iap/v1beta1/iap-gen.go b/iap/v1beta1/iap-gen.go index 491726cc5e2..5ec6644e0c4 100644 --- a/iap/v1beta1/iap-gen.go +++ b/iap/v1beta1/iap-gen.go @@ -158,8 +158,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 @@ -459,7 +459,7 @@ func (s *Policy) 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"` @@ -490,7 +490,7 @@ func (s *SetIamPolicyRequest) 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"` diff --git a/ml/v1/ml-api.json b/ml/v1/ml-api.json index 69fdb569a1a..1253da96c34 100644 --- a/ml/v1/ml-api.json +++ b/ml/v1/ml-api.json @@ -1486,7 +1486,7 @@ } } }, - "revision": "20220318", + "revision": "20220409", "rootUrl": "https://ml.googleapis.com/", "schemas": { "GoogleApi__HttpBody": { @@ -3705,7 +3705,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" }, @@ -3755,7 +3755,7 @@ "properties": { "policy": { "$ref": "GoogleIamV1__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\"`", @@ -3770,7 +3770,7 @@ "id": "GoogleIamV1__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/ml/v1/ml-gen.go b/ml/v1/ml-gen.go index ee8ed40809e..85030e851d7 100644 --- a/ml/v1/ml-gen.go +++ b/ml/v1/ml-gen.go @@ -4258,8 +4258,8 @@ type GoogleIamV1__Binding struct { // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *GoogleType__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 @@ -4434,7 +4434,7 @@ func (s *GoogleIamV1__Policy) MarshalJSON() ([]byte, error) { type GoogleIamV1__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 *GoogleIamV1__Policy `json:"policy,omitempty"` @@ -4471,7 +4471,7 @@ func (s *GoogleIamV1__SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // `TestIamPermissions` method. type GoogleIamV1__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"` diff --git a/recommendationengine/v1beta1/recommendationengine-api.json b/recommendationengine/v1beta1/recommendationengine-api.json index 4a8d5dc5ac1..3d058333fd7 100644 --- a/recommendationengine/v1beta1/recommendationengine-api.json +++ b/recommendationengine/v1beta1/recommendationengine-api.json @@ -842,7 +842,7 @@ } } }, - "revision": "20211202", + "revision": "20220407", "rootUrl": "https://recommendationengine.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -1465,7 +1465,7 @@ }, "userEvent": { "$ref": "GoogleCloudRecommendationengineV1beta1UserEvent", - "description": "Required. Context about the user, what they are looking at and what action they took to trigger the predict request. Note that this user event detail won't be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging." + "description": "Required. Context about the user, what they are looking at and what action they took to trigger the predict request. Note that this user event detail won't be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging. Don't set UserInfo.visitor_id or UserInfo.user_id to the same fixed ID for different users. If you are trying to receive non-personalized recommendations (not recommended; this can negatively impact model performance), instead set UserInfo.visitor_id to a random unique ID and leave UserInfo.user_id unset." } }, "type": "object" @@ -1945,11 +1945,11 @@ "type": "string" }, "userId": { - "description": "Optional. Unique identifier for logged-in user with a length limit of 128 bytes. Required only for logged-in users.", + "description": "Optional. Unique identifier for logged-in user with a length limit of 128 bytes. Required only for logged-in users. Don't set for anonymous users. Don't set the field to the same fixed ID for different users. This mixes the event history of those users together, which results in degraded model quality.", "type": "string" }, "visitorId": { - "description": "Required. A unique identifier for tracking visitors with a length limit of 128 bytes. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor logs in or out of the website. Maximum length 128 bytes. Cannot be empty.", + "description": "Required. A unique identifier for tracking visitors with a length limit of 128 bytes. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor logs in or out of the website. Maximum length 128 bytes. Cannot be empty. Don't set the field to the same fixed ID for different users. This mixes the event history of those users together, which results in degraded model quality.", "type": "string" } }, @@ -2009,7 +2009,7 @@ "type": "object" }, "GoogleProtobufEmpty": { - "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": "GoogleProtobufEmpty", "properties": {}, "type": "object" diff --git a/recommendationengine/v1beta1/recommendationengine-gen.go b/recommendationengine/v1beta1/recommendationengine-gen.go index 69f72053e11..9c7c780c913 100644 --- a/recommendationengine/v1beta1/recommendationengine-gen.go +++ b/recommendationengine/v1beta1/recommendationengine-gen.go @@ -1477,7 +1477,12 @@ type GoogleCloudRecommendationengineV1beta1PredictRequest struct { // UserEvent: Required. Context about the user, what they are looking at // and what action they took to trigger the predict request. Note that // this user event detail won't be ingested to userEvent logs. Thus, a - // separate userEvent write request is required for event logging. + // separate userEvent write request is required for event logging. Don't + // set UserInfo.visitor_id or UserInfo.user_id to the same fixed ID for + // different users. If you are trying to receive non-personalized + // recommendations (not recommended; this can negatively impact model + // performance), instead set UserInfo.visitor_id to a random unique ID + // and leave UserInfo.user_id unset. UserEvent *GoogleCloudRecommendationengineV1beta1UserEvent `json:"userEvent,omitempty"` // ForceSendFields is a list of field names (e.g. "DryRun") to @@ -2399,7 +2404,10 @@ type GoogleCloudRecommendationengineV1beta1UserInfo struct { UserAgent string `json:"userAgent,omitempty"` // UserId: Optional. Unique identifier for logged-in user with a length - // limit of 128 bytes. Required only for logged-in users. + // limit of 128 bytes. Required only for logged-in users. Don't set for + // anonymous users. Don't set the field to the same fixed ID for + // different users. This mixes the event history of those users + // together, which results in degraded model quality. UserId string `json:"userId,omitempty"` // VisitorId: Required. A unique identifier for tracking visitors with a @@ -2407,7 +2415,9 @@ type GoogleCloudRecommendationengineV1beta1UserInfo struct { // with an HTTP cookie, which should be able to uniquely identify a // visitor on a single device. This unique identifier should not change // if the visitor logs in or out of the website. Maximum length 128 - // bytes. Cannot be empty. + // bytes. Cannot be empty. Don't set the field to the same fixed ID for + // different users. This mixes the event history of those users + // together, which results in degraded model quality. VisitorId string `json:"visitorId,omitempty"` // ForceSendFields is a list of field names (e.g. "DirectUserRequest") @@ -2537,8 +2547,7 @@ func (s *GoogleLongrunningOperation) MarshalJSON() ([]byte, error) { // 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 `{}`. +// returns (google.protobuf.Empty); } type GoogleProtobufEmpty struct { // ServerResponse contains the HTTP response code and headers from the // server. diff --git a/run/v1/run-api.json b/run/v1/run-api.json index 33b13ebcc65..5a5ed029480 100644 --- a/run/v1/run-api.json +++ b/run/v1/run-api.json @@ -2261,7 +2261,7 @@ } } }, - "revision": "20220401", + "revision": "20220408", "rootUrl": "https://run.googleapis.com/", "schemas": { "Addressable": { @@ -2346,7 +2346,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" }, @@ -3659,12 +3659,12 @@ "description": "(Optional) HTTPGet specifies the http request to perform. A field inlined from the Handler message." }, "initialDelaySeconds": { - "description": "(Optional) Number of seconds after the container has started before liveness probes are initiated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes", + "description": "(Optional) Number of seconds after the container has started before liveness probes are initiated. Defaults to 0 seconds. Minimum value is 0. Max value for liveness probe is 3600. Max value for startup probe is 240. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes", "format": "int32", "type": "integer" }, "periodSeconds": { - "description": "(Optional) How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1. Maximum value is 3600. Must be greater or equal than timeout_seconds.", + "description": "(Optional) How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1. Max value for liveness probe is 3600. Max value for startup probe is 240. Must be greater or equal than timeout_seconds.", "format": "int32", "type": "integer" }, @@ -4110,7 +4110,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\"`", @@ -4364,7 +4364,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/run/v1/run-gen.go b/run/v1/run-gen.go index cfbb1e1e4cb..34196213232 100644 --- a/run/v1/run-gen.go +++ b/run/v1/run-gen.go @@ -547,8 +547,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 @@ -2962,13 +2962,16 @@ type Probe struct { HttpGet *HTTPGetAction `json:"httpGet,omitempty"` // InitialDelaySeconds: (Optional) Number of seconds after the container - // has started before liveness probes are initiated. More info: + // has started before liveness probes are initiated. Defaults to 0 + // seconds. Minimum value is 0. Max value for liveness probe is 3600. + // Max value for startup probe is 240. More info: // https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes InitialDelaySeconds int64 `json:"initialDelaySeconds,omitempty"` // PeriodSeconds: (Optional) How often (in seconds) to perform the - // probe. Default to 10 seconds. Minimum value is 1. Maximum value is - // 3600. Must be greater or equal than timeout_seconds. + // probe. Default to 10 seconds. Minimum value is 1. Max value for + // liveness probe is 3600. Max value for startup probe is 240. Must be + // greater or equal than timeout_seconds. PeriodSeconds int64 `json:"periodSeconds,omitempty"` // SuccessThreshold: (Optional) Minimum consecutive successes for the @@ -3842,7 +3845,7 @@ func (s *ServiceStatus) 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"` @@ -4327,7 +4330,7 @@ func (s *TaskTemplateSpec) 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"` diff --git a/secretmanager/v1/secretmanager-api.json b/secretmanager/v1/secretmanager-api.json index a725b718cc1..d95ea6a2e81 100644 --- a/secretmanager/v1/secretmanager-api.json +++ b/secretmanager/v1/secretmanager-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" }, @@ -643,7 +643,7 @@ } } }, - "revision": "20220318", + "revision": "20220408", "rootUrl": "https://secretmanager.googleapis.com/", "schemas": { "AccessSecretVersionResponse": { @@ -752,7 +752,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" }, @@ -876,7 +876,7 @@ "type": "string" }, "totalSize": { - "description": "The total number of SecretVersions.", + "description": "The total number of SecretVersions but 0 when the ListSecretsRequest.filter field is set.", "format": "int32", "type": "integer" }, @@ -906,7 +906,7 @@ "type": "array" }, "totalSize": { - "description": "The total number of Secrets.", + "description": "The total number of Secrets but 0 when the ListSecretsRequest.filter field is set.", "format": "int32", "type": "integer" } @@ -1189,7 +1189,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\"`", @@ -1204,7 +1204,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/secretmanager/v1/secretmanager-gen.go b/secretmanager/v1/secretmanager-gen.go index 69b1b07d7ec..716e8802dd7 100644 --- a/secretmanager/v1/secretmanager-gen.go +++ b/secretmanager/v1/secretmanager-gen.go @@ -427,8 +427,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 @@ -764,7 +764,8 @@ type ListSecretVersionsResponse struct { // next page. NextPageToken string `json:"nextPageToken,omitempty"` - // TotalSize: The total number of SecretVersions. + // TotalSize: The total number of SecretVersions but 0 when the + // ListSecretsRequest.filter field is set. TotalSize int64 `json:"totalSize,omitempty"` // Versions: The list of SecretVersions sorted in reverse by create_time @@ -810,7 +811,8 @@ type ListSecretsResponse struct { // first). Secrets []*Secret `json:"secrets,omitempty"` - // TotalSize: The total number of Secrets. + // TotalSize: The total number of Secrets but 0 when the + // ListSecretsRequest.filter field is set. TotalSize int64 `json:"totalSize,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1375,7 +1377,7 @@ func (s *SecretVersion) 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"` @@ -1412,7 +1414,7 @@ func (s *SetIamPolicyRequest) 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"` @@ -1738,8 +1740,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 @@ -1868,7 +1870,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/secretmanager/v1beta1/secretmanager-api.json b/secretmanager/v1beta1/secretmanager-api.json index d0eb05ecff0..9a328543623 100644 --- a/secretmanager/v1beta1/secretmanager-api.json +++ b/secretmanager/v1beta1/secretmanager-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" }, @@ -628,7 +628,7 @@ } } }, - "revision": "20220318", + "revision": "20220408", "rootUrl": "https://secretmanager.googleapis.com/", "schemas": { "AccessSecretVersionResponse": { @@ -720,7 +720,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" }, @@ -1023,7 +1023,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\"`", @@ -1038,7 +1038,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/secretmanager/v1beta1/secretmanager-gen.go b/secretmanager/v1beta1/secretmanager-gen.go index ec5cca9c6f1..06ae64579b8 100644 --- a/secretmanager/v1beta1/secretmanager-gen.go +++ b/secretmanager/v1beta1/secretmanager-gen.go @@ -362,8 +362,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 @@ -995,7 +995,7 @@ func (s *SecretVersion) 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"` @@ -1032,7 +1032,7 @@ func (s *SetIamPolicyRequest) 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"` @@ -1295,8 +1295,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 @@ -1425,7 +1425,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/securitycenter/v1/securitycenter-api.json b/securitycenter/v1/securitycenter-api.json index 428269207bf..b8dfbe79942 100644 --- a/securitycenter/v1/securitycenter-api.json +++ b/securitycenter/v1/securitycenter-api.json @@ -3058,7 +3058,7 @@ } } }, - "revision": "20220401", + "revision": "20220411", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -3228,7 +3228,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" }, @@ -4595,7 +4595,8 @@ "MODIFY_CLOUD_COMPUTE_INFRASTRUCTURE", "EXPLOIT_PUBLIC_FACING_APPLICATION", "MODIFY_AUTHENTICATION_PROCESS", - "DATA_DESTRUCTION" + "DATA_DESTRUCTION", + "DOMAIN_POLICY_MODIFICATION" ], "enumDescriptions": [ "Unspecified value.", @@ -4627,7 +4628,8 @@ "T1578", "T1190", "T1556", - "T1485" + "T1485", + "T1484" ], "type": "string" }, @@ -4704,7 +4706,8 @@ "MODIFY_CLOUD_COMPUTE_INFRASTRUCTURE", "EXPLOIT_PUBLIC_FACING_APPLICATION", "MODIFY_AUTHENTICATION_PROCESS", - "DATA_DESTRUCTION" + "DATA_DESTRUCTION", + "DOMAIN_POLICY_MODIFICATION" ], "enumDescriptions": [ "Unspecified value.", @@ -4736,7 +4739,8 @@ "T1578", "T1190", "T1556", - "T1485" + "T1485", + "T1484" ], "type": "string" }, @@ -5028,7 +5032,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\"`", @@ -5127,7 +5131,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/securitycenter/v1/securitycenter-gen.go b/securitycenter/v1/securitycenter-gen.go index c22b4e27b82..17694cc23fe 100644 --- a/securitycenter/v1/securitycenter-gen.go +++ b/securitycenter/v1/securitycenter-gen.go @@ -717,8 +717,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 @@ -3033,6 +3033,7 @@ type MitreAttack struct { // "EXPLOIT_PUBLIC_FACING_APPLICATION" - T1190 // "MODIFY_AUTHENTICATION_PROCESS" - T1556 // "DATA_DESTRUCTION" - T1485 + // "DOMAIN_POLICY_MODIFICATION" - T1484 AdditionalTechniques []string `json:"additionalTechniques,omitempty"` // PrimaryTactic: The MITRE ATT&CK tactic most closely represented by @@ -3095,6 +3096,7 @@ type MitreAttack struct { // "EXPLOIT_PUBLIC_FACING_APPLICATION" - T1190 // "MODIFY_AUTHENTICATION_PROCESS" - T1556 // "DATA_DESTRUCTION" - T1485 + // "DOMAIN_POLICY_MODIFICATION" - T1484 PrimaryTechniques []string `json:"primaryTechniques,omitempty"` // Version: The MITRE ATT&CK version referenced by the above fields. @@ -3663,7 +3665,7 @@ func (s *SetFindingStateRequest) 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"` @@ -3876,7 +3878,7 @@ func (s *StreamingConfig) 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"` diff --git a/securitycenter/v1beta1/securitycenter-api.json b/securitycenter/v1beta1/securitycenter-api.json index 299d4a77078..b95e3b20ebc 100644 --- a/securitycenter/v1beta1/securitycenter-api.json +++ b/securitycenter/v1beta1/securitycenter-api.json @@ -896,7 +896,7 @@ } } }, - "revision": "20220401", + "revision": "20220411", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -1051,7 +1051,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" }, @@ -2378,7 +2378,8 @@ "MODIFY_CLOUD_COMPUTE_INFRASTRUCTURE", "EXPLOIT_PUBLIC_FACING_APPLICATION", "MODIFY_AUTHENTICATION_PROCESS", - "DATA_DESTRUCTION" + "DATA_DESTRUCTION", + "DOMAIN_POLICY_MODIFICATION" ], "enumDescriptions": [ "Unspecified value.", @@ -2410,7 +2411,8 @@ "T1578", "T1190", "T1556", - "T1485" + "T1485", + "T1484" ], "type": "string" }, @@ -2487,7 +2489,8 @@ "MODIFY_CLOUD_COMPUTE_INFRASTRUCTURE", "EXPLOIT_PUBLIC_FACING_APPLICATION", "MODIFY_AUTHENTICATION_PROCESS", - "DATA_DESTRUCTION" + "DATA_DESTRUCTION", + "DOMAIN_POLICY_MODIFICATION" ], "enumDescriptions": [ "Unspecified value.", @@ -2519,7 +2522,8 @@ "T1578", "T1190", "T1556", - "T1485" + "T1485", + "T1484" ], "type": "string" }, @@ -2722,7 +2726,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\"`", @@ -2783,7 +2787,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/securitycenter/v1beta1/securitycenter-gen.go b/securitycenter/v1beta1/securitycenter-gen.go index 66eeb4e458e..1554ea790dd 100644 --- a/securitycenter/v1beta1/securitycenter-gen.go +++ b/securitycenter/v1beta1/securitycenter-gen.go @@ -448,8 +448,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 @@ -2587,6 +2587,7 @@ type MitreAttack struct { // "EXPLOIT_PUBLIC_FACING_APPLICATION" - T1190 // "MODIFY_AUTHENTICATION_PROCESS" - T1556 // "DATA_DESTRUCTION" - T1485 + // "DOMAIN_POLICY_MODIFICATION" - T1484 AdditionalTechniques []string `json:"additionalTechniques,omitempty"` // PrimaryTactic: The MITRE ATT&CK tactic most closely represented by @@ -2649,6 +2650,7 @@ type MitreAttack struct { // "EXPLOIT_PUBLIC_FACING_APPLICATION" - T1190 // "MODIFY_AUTHENTICATION_PROCESS" - T1556 // "DATA_DESTRUCTION" - T1485 + // "DOMAIN_POLICY_MODIFICATION" - T1484 PrimaryTechniques []string `json:"primaryTechniques,omitempty"` // Version: The MITRE ATT&CK version referenced by the above fields. @@ -3088,7 +3090,7 @@ func (s *SetFindingStateRequest) 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"` @@ -3220,7 +3222,7 @@ func (s *Status) 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"` diff --git a/securitycenter/v1beta2/securitycenter-api.json b/securitycenter/v1beta2/securitycenter-api.json index a14ecdaa657..c1271bdb970 100644 --- a/securitycenter/v1beta2/securitycenter-api.json +++ b/securitycenter/v1beta2/securitycenter-api.json @@ -1667,7 +1667,7 @@ } } }, - "revision": "20220401", + "revision": "20220411", "rootUrl": "https://securitycenter.googleapis.com/", "schemas": { "Access": { @@ -2778,7 +2778,8 @@ "MODIFY_CLOUD_COMPUTE_INFRASTRUCTURE", "EXPLOIT_PUBLIC_FACING_APPLICATION", "MODIFY_AUTHENTICATION_PROCESS", - "DATA_DESTRUCTION" + "DATA_DESTRUCTION", + "DOMAIN_POLICY_MODIFICATION" ], "enumDescriptions": [ "Unspecified value.", @@ -2810,7 +2811,8 @@ "T1578", "T1190", "T1556", - "T1485" + "T1485", + "T1484" ], "type": "string" }, @@ -2887,7 +2889,8 @@ "MODIFY_CLOUD_COMPUTE_INFRASTRUCTURE", "EXPLOIT_PUBLIC_FACING_APPLICATION", "MODIFY_AUTHENTICATION_PROCESS", - "DATA_DESTRUCTION" + "DATA_DESTRUCTION", + "DOMAIN_POLICY_MODIFICATION" ], "enumDescriptions": [ "Unspecified value.", @@ -2919,7 +2922,8 @@ "T1578", "T1190", "T1556", - "T1485" + "T1485", + "T1484" ], "type": "string" }, diff --git a/securitycenter/v1beta2/securitycenter-gen.go b/securitycenter/v1beta2/securitycenter-gen.go index a9c9ae6b3e9..3b597a10937 100644 --- a/securitycenter/v1beta2/securitycenter-gen.go +++ b/securitycenter/v1beta2/securitycenter-gen.go @@ -1957,6 +1957,7 @@ type MitreAttack struct { // "EXPLOIT_PUBLIC_FACING_APPLICATION" - T1190 // "MODIFY_AUTHENTICATION_PROCESS" - T1556 // "DATA_DESTRUCTION" - T1485 + // "DOMAIN_POLICY_MODIFICATION" - T1484 AdditionalTechniques []string `json:"additionalTechniques,omitempty"` // PrimaryTactic: The MITRE ATT&CK tactic most closely represented by @@ -2019,6 +2020,7 @@ type MitreAttack struct { // "EXPLOIT_PUBLIC_FACING_APPLICATION" - T1190 // "MODIFY_AUTHENTICATION_PROCESS" - T1556 // "DATA_DESTRUCTION" - T1485 + // "DOMAIN_POLICY_MODIFICATION" - T1484 PrimaryTechniques []string `json:"primaryTechniques,omitempty"` // Version: The MITRE ATT&CK version referenced by the above fields. diff --git a/slides/v1/slides-api.json b/slides/v1/slides-api.json index 733a666b45a..3460d98ca26 100644 --- a/slides/v1/slides-api.json +++ b/slides/v1/slides-api.json @@ -313,7 +313,7 @@ } } }, - "revision": "20220322", + "revision": "20220404", "rootUrl": "https://slides.googleapis.com/", "schemas": { "AffineTransform": { @@ -2523,7 +2523,7 @@ "enumDescriptions": [ "Unspecified image replace method. This value must not be used.", "Scales and centers the image to fit within the bounds of the original shape and maintains the image's aspect ratio. The rendered size of the image may be smaller than the size of the shape. This is the default method when one is not specified.", - "Scales and centers the image to fill the bounds of the original shape. The image may be cropped in order to fill the shape. The rendered size of the image will be the same as that of the original shape." + "Scales and centers the image to fill the bounds of the original shape. The image may be cropped in order to fill the shape. The rendered size of the image will be the same as the original shape." ], "type": "string" }, @@ -2655,7 +2655,7 @@ "id": "ReplaceImageRequest", "properties": { "imageObjectId": { - "description": "The ID of the existing image that will be replaced.", + "description": "The ID of the existing image that will be replaced. The ID can be retrieved from the response of a get request.", "type": "string" }, "imageReplaceMethod": { @@ -2668,12 +2668,12 @@ "enumDescriptions": [ "Unspecified image replace method. This value must not be used.", "Scales and centers the image to fit within the bounds of the original shape and maintains the image's aspect ratio. The rendered size of the image may be smaller than the size of the shape. This is the default method when one is not specified.", - "Scales and centers the image to fill the bounds of the original shape. The image may be cropped in order to fill the shape. The rendered size of the image will be the same as that of the original shape." + "Scales and centers the image to fill the bounds of the original shape. The image may be cropped in order to fill the shape. The rendered size of the image will be the same as the original shape." ], "type": "string" }, "url": { - "description": "The image URL. The image is fetched once at insertion time and a copy is stored for display inside the presentation. Images must be less than 50MB in size, cannot exceed 25 megapixels, and must be in one of PNG, JPEG, or GIF format. The provided URL can be at most 2 kB in length. The URL itself is saved with the image, and exposed via the Image.source_url field.", + "description": "The image URL. The image is fetched once at insertion time and a copy is stored for display inside the presentation. Images must be less than 50MB, cannot exceed 25 megapixels, and must be in PNG, JPEG, or GIF format. The provided URL can't surpass 2 KB in length. The URL is saved with the image, and exposed through the Image.source_url field.", "type": "string" } }, diff --git a/slides/v1/slides-gen.go b/slides/v1/slides-gen.go index 2edeef57f98..b9ed3b2301b 100644 --- a/slides/v1/slides-gen.go +++ b/slides/v1/slides-gen.go @@ -3843,7 +3843,7 @@ type ReplaceAllShapesWithImageRequest struct { // shape. This is the default method when one is not specified. // "CENTER_CROP" - Scales and centers the image to fill the bounds of // the original shape. The image may be cropped in order to fill the - // shape. The rendered size of the image will be the same as that of the + // shape. The rendered size of the image will be the same as the // original shape. ImageReplaceMethod string `json:"imageReplaceMethod,omitempty"` @@ -4094,6 +4094,7 @@ func (s *ReplaceAllTextResponse) MarshalJSON() ([]byte, error) { // image. type ReplaceImageRequest struct { // ImageObjectId: The ID of the existing image that will be replaced. + // The ID can be retrieved from the response of a get request. ImageObjectId string `json:"imageObjectId,omitempty"` // ImageReplaceMethod: The replacement method. @@ -4107,16 +4108,16 @@ type ReplaceImageRequest struct { // shape. This is the default method when one is not specified. // "CENTER_CROP" - Scales and centers the image to fill the bounds of // the original shape. The image may be cropped in order to fill the - // shape. The rendered size of the image will be the same as that of the + // shape. The rendered size of the image will be the same as the // original shape. ImageReplaceMethod string `json:"imageReplaceMethod,omitempty"` // Url: The image URL. The image is fetched once at insertion time and a // copy is stored for display inside the presentation. Images must be - // less than 50MB in size, cannot exceed 25 megapixels, and must be in - // one of PNG, JPEG, or GIF format. The provided URL can be at most 2 kB - // in length. The URL itself is saved with the image, and exposed via - // the Image.source_url field. + // less than 50MB, cannot exceed 25 megapixels, and must be in PNG, + // JPEG, or GIF format. The provided URL can't surpass 2 KB in length. + // The URL is saved with the image, and exposed through the + // Image.source_url field. Url string `json:"url,omitempty"` // ForceSendFields is a list of field names (e.g. "ImageObjectId") to From 89f1c62055fecabdf3cbdfc6a88e1e3d6cfdfcc7 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Thu, 14 Apr 2022 07:25:11 -0700 Subject: [PATCH 11/17] feat(all): auto-regenerate discovery clients (#1511) --- api-list.json | 19 +- .../v1/binaryauthorization-api.json | 12 +- .../v1/binaryauthorization-gen.go | 18 +- .../v1beta1/binaryauthorization-api.json | 12 +- .../v1beta1/binaryauthorization-gen.go | 18 +- .../v1/containeranalysis-api.json | 8 +- containeranalysis/v1/containeranalysis-gen.go | 8 +- .../v1alpha1/containeranalysis-api.json | 8 +- .../v1alpha1/containeranalysis-gen.go | 8 +- .../v1beta1/containeranalysis-api.json | 8 +- .../v1beta1/containeranalysis-gen.go | 8 +- dataflow/v1b3/dataflow-api.json | 28 +- dataflow/v1b3/dataflow-gen.go | 42 +- .../v0.alpha/deploymentmanager-api.json | 4 +- .../v0.alpha/deploymentmanager-gen.go | 4 +- .../v2/deploymentmanager-api.json | 4 +- deploymentmanager/v2/deploymentmanager-gen.go | 4 +- .../v2beta/deploymentmanager-api.json | 4 +- .../v2beta/deploymentmanager-gen.go | 4 +- drive/v2/drive-api.json | 6 +- drive/v2/drive-gen.go | 6 +- drive/v3/drive-api.json | 6 +- drive/v3/drive-gen.go | 4 +- healthcare/v1/healthcare-api.json | 4 +- healthcare/v1/healthcare-gen.go | 3 +- healthcare/v1beta1/healthcare-api.json | 4 +- healthcare/v1beta1/healthcare-gen.go | 3 +- logging/v2/logging-api.json | 206 +++- logging/v2/logging-gen.go | 1034 ++++++++++++++++- retail/v2/retail-api.json | 24 +- retail/v2/retail-gen.go | 129 +- retail/v2alpha/retail-api.json | 43 +- retail/v2alpha/retail-gen.go | 148 +-- retail/v2beta/retail-api.json | 41 +- retail/v2beta/retail-gen.go | 144 +-- .../v1/servicemanagement-api.json | 14 +- servicemanagement/v1/servicemanagement-gen.go | 27 +- speech/v1/speech-api.json | 4 +- speech/v1/speech-gen.go | 3 +- speech/v1p1beta1/speech-api.json | 4 +- speech/v1p1beta1/speech-gen.go | 3 +- 41 files changed, 1635 insertions(+), 446 deletions(-) diff --git a/api-list.json b/api-list.json index 3c4a14d8595..8f163d55730 100644 --- a/api-list.json +++ b/api-list.json @@ -556,28 +556,13 @@ "documentationLink": "https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/", "preferred": true }, - { - "kind": "discovery#directoryItem", - "id": "baremetalsolution:v1alpha1", - "name": "baremetalsolution", - "version": "v1alpha1", - "title": "Bare Metal Solution API", - "description": "Provides ways to manage Bare Metal Solution hardware installed in a regional extension located near a Google Cloud data center.", - "discoveryRestUrl": "https://baremetalsolution.googleapis.com/$discovery/rest?version=v1alpha1", - "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/bare-metal", - "preferred": false - }, { "kind": "discovery#directoryItem", "id": "baremetalsolution:v1", "name": "baremetalsolution", "version": "v1", "title": "Bare Metal Solution API", - "description": "Provides ways to manage Bare Metal Solution hardware installed in a regional extension located near a Google Cloud data center.", + "description": "Bare Metal Solution provides hardware to run specialized workloads with low latency on Google Cloud.", "discoveryRestUrl": "https://baremetalsolution.googleapis.com/$discovery/rest?version=v1", "icons": { "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", @@ -592,7 +577,7 @@ "name": "baremetalsolution", "version": "v2", "title": "Bare Metal Solution API", - "description": "Provides ways to manage Bare Metal Solution hardware installed in a regional extension located near a Google Cloud data center.", + "description": "Bare Metal Solution provides hardware to run specialized workloads with low latency on Google Cloud.", "discoveryRestUrl": "https://baremetalsolution.googleapis.com/$discovery/rest?version=v2", "icons": { "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", diff --git a/binaryauthorization/v1/binaryauthorization-api.json b/binaryauthorization/v1/binaryauthorization-api.json index 8bcca307865..77e3005bdc9 100644 --- a/binaryauthorization/v1/binaryauthorization-api.json +++ b/binaryauthorization/v1/binaryauthorization-api.json @@ -551,7 +551,7 @@ } } }, - "revision": "20220318", + "revision": "20220408", "rootUrl": "https://binaryauthorization.googleapis.com/", "schemas": { "AdmissionRule": { @@ -644,7 +644,7 @@ "type": "string" }, "etag": { - "description": "Optional. Used to prevent updating the attestor when another request has updated it since it was retrieved.", + "description": "Optional. A checksum, returned by the server, that can be sent on update requests to ensure the attestor has an up-to-date value before attempting to update it. See https://google.aip.dev/154.", "type": "string" }, "name": { @@ -696,7 +696,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" }, @@ -874,7 +874,7 @@ "type": "string" }, "etag": { - "description": "Optional. Used to prevent updating the policy when another request has updated it since it was retrieved.", + "description": "Optional. A checksum, returned by the server, that can be sent on update requests to ensure the policy has an up-to-date value before attempting to update it. See https://google.aip.dev/154.", "type": "string" }, "globalPolicyEvaluationMode": { @@ -932,7 +932,7 @@ "properties": { "policy": { "$ref": "IamPolicy", - "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." } }, "type": "object" @@ -958,7 +958,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/binaryauthorization/v1/binaryauthorization-gen.go b/binaryauthorization/v1/binaryauthorization-gen.go index 59a1849c001..ef22da8fa01 100644 --- a/binaryauthorization/v1/binaryauthorization-gen.go +++ b/binaryauthorization/v1/binaryauthorization-gen.go @@ -339,8 +339,9 @@ type Attestor struct { // updated. The field may be displayed in chooser dialogs. Description string `json:"description,omitempty"` - // Etag: Optional. Used to prevent updating the attestor when another - // request has updated it since it was retrieved. + // Etag: Optional. A checksum, returned by the server, that can be sent + // on update requests to ensure the attestor has an up-to-date value + // before attempting to update it. See https://google.aip.dev/154. Etag string `json:"etag,omitempty"` // Name: Required. The resource name, in the format: @@ -449,8 +450,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 @@ -857,8 +858,9 @@ type Policy struct { // Description: Optional. A descriptive comment. Description string `json:"description,omitempty"` - // Etag: Optional. Used to prevent updating the policy when another - // request has updated it since it was retrieved. + // Etag: Optional. A checksum, returned by the server, that can be sent + // on update requests to ensure the policy has an up-to-date value + // before attempting to update it. See https://google.aip.dev/154. Etag string `json:"etag,omitempty"` // GlobalPolicyEvaluationMode: Optional. Controls the evaluation of a @@ -930,7 +932,7 @@ func (s *Policy) 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 *IamPolicy `json:"policy,omitempty"` @@ -1028,7 +1030,7 @@ func (s *Signature) 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"` diff --git a/binaryauthorization/v1beta1/binaryauthorization-api.json b/binaryauthorization/v1beta1/binaryauthorization-api.json index c31a470a6c4..ad3e4c364c5 100644 --- a/binaryauthorization/v1beta1/binaryauthorization-api.json +++ b/binaryauthorization/v1beta1/binaryauthorization-api.json @@ -551,7 +551,7 @@ } } }, - "revision": "20220318", + "revision": "20220408", "rootUrl": "https://binaryauthorization.googleapis.com/", "schemas": { "AdmissionRule": { @@ -644,7 +644,7 @@ "type": "string" }, "etag": { - "description": "Optional. Used to prevent updating the attestor when another request has updated it since it was retrieved.", + "description": "Optional. A checksum, returned by the server, that can be sent on update requests to ensure the attestor has an up-to-date value before attempting to update it. See https://google.aip.dev/154.", "type": "string" }, "name": { @@ -696,7 +696,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" }, @@ -874,7 +874,7 @@ "type": "string" }, "etag": { - "description": "Optional. Used to prevent updating the policy when another request has updated it since it was retrieved.", + "description": "Optional. A checksum, returned by the server, that can be sent on update requests to ensure the policy has an up-to-date value before attempting to update it. See https://google.aip.dev/154.", "type": "string" }, "globalPolicyEvaluationMode": { @@ -932,7 +932,7 @@ "properties": { "policy": { "$ref": "IamPolicy", - "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." } }, "type": "object" @@ -958,7 +958,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/binaryauthorization/v1beta1/binaryauthorization-gen.go b/binaryauthorization/v1beta1/binaryauthorization-gen.go index f67d191380d..dbb270287f7 100644 --- a/binaryauthorization/v1beta1/binaryauthorization-gen.go +++ b/binaryauthorization/v1beta1/binaryauthorization-gen.go @@ -341,8 +341,9 @@ type Attestor struct { // updated. The field may be displayed in chooser dialogs. Description string `json:"description,omitempty"` - // Etag: Optional. Used to prevent updating the attestor when another - // request has updated it since it was retrieved. + // Etag: Optional. A checksum, returned by the server, that can be sent + // on update requests to ensure the attestor has an up-to-date value + // before attempting to update it. See https://google.aip.dev/154. Etag string `json:"etag,omitempty"` // Name: Required. The resource name, in the format: @@ -451,8 +452,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 @@ -859,8 +860,9 @@ type Policy struct { // Description: Optional. A descriptive comment. Description string `json:"description,omitempty"` - // Etag: Optional. Used to prevent updating the policy when another - // request has updated it since it was retrieved. + // Etag: Optional. A checksum, returned by the server, that can be sent + // on update requests to ensure the policy has an up-to-date value + // before attempting to update it. See https://google.aip.dev/154. Etag string `json:"etag,omitempty"` // GlobalPolicyEvaluationMode: Optional. Controls the evaluation of a @@ -932,7 +934,7 @@ func (s *Policy) 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 *IamPolicy `json:"policy,omitempty"` @@ -1030,7 +1032,7 @@ func (s *Signature) 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"` diff --git a/containeranalysis/v1/containeranalysis-api.json b/containeranalysis/v1/containeranalysis-api.json index 88199457b68..e929ddf3044 100644 --- a/containeranalysis/v1/containeranalysis-api.json +++ b/containeranalysis/v1/containeranalysis-api.json @@ -755,7 +755,7 @@ } } }, - "revision": "20220318", + "revision": "20220408", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AliasContext": { @@ -909,7 +909,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" }, @@ -3757,7 +3757,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." } }, "type": "object" @@ -3998,7 +3998,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/containeranalysis/v1/containeranalysis-gen.go b/containeranalysis/v1/containeranalysis-gen.go index 767ef49f5e1..34050ba1afc 100644 --- a/containeranalysis/v1/containeranalysis-gen.go +++ b/containeranalysis/v1/containeranalysis-gen.go @@ -485,8 +485,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 @@ -4749,7 +4749,7 @@ func (s *RepoId) 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"` @@ -5224,7 +5224,7 @@ func (s *Subject) 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"` diff --git a/containeranalysis/v1alpha1/containeranalysis-api.json b/containeranalysis/v1alpha1/containeranalysis-api.json index ffc38014c4c..f64b07c0c04 100644 --- a/containeranalysis/v1alpha1/containeranalysis-api.json +++ b/containeranalysis/v1alpha1/containeranalysis-api.json @@ -1229,7 +1229,7 @@ } } }, - "revision": "20220318", + "revision": "20220408", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "Artifact": { @@ -1313,7 +1313,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" }, @@ -4832,7 +4832,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." } }, "type": "object" @@ -5097,7 +5097,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/containeranalysis/v1alpha1/containeranalysis-gen.go b/containeranalysis/v1alpha1/containeranalysis-gen.go index 7d738ab7bae..ef841096927 100644 --- a/containeranalysis/v1alpha1/containeranalysis-gen.go +++ b/containeranalysis/v1alpha1/containeranalysis-gen.go @@ -448,8 +448,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 @@ -5628,7 +5628,7 @@ func (s *ScanConfig) 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"` @@ -6088,7 +6088,7 @@ func (s *Subject) 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"` diff --git a/containeranalysis/v1beta1/containeranalysis-api.json b/containeranalysis/v1beta1/containeranalysis-api.json index 9dc31eaa7ff..e6c252fdf13 100644 --- a/containeranalysis/v1beta1/containeranalysis-api.json +++ b/containeranalysis/v1beta1/containeranalysis-api.json @@ -853,7 +853,7 @@ } } }, - "revision": "20220318", + "revision": "20220408", "rootUrl": "https://containeranalysis.googleapis.com/", "schemas": { "AliasContext": { @@ -1033,7 +1033,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" }, @@ -4357,7 +4357,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." } }, "type": "object" @@ -4488,7 +4488,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/containeranalysis/v1beta1/containeranalysis-gen.go b/containeranalysis/v1beta1/containeranalysis-gen.go index bfbcf7a6d05..1bf0a5698f4 100644 --- a/containeranalysis/v1beta1/containeranalysis-gen.go +++ b/containeranalysis/v1beta1/containeranalysis-gen.go @@ -573,8 +573,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 @@ -5471,7 +5471,7 @@ func (s *ScanConfig) 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"` @@ -5750,7 +5750,7 @@ func (s *Status) 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"` diff --git a/dataflow/v1b3/dataflow-api.json b/dataflow/v1b3/dataflow-api.json index a41dc616ef9..c0398af1735 100644 --- a/dataflow/v1b3/dataflow-api.json +++ b/dataflow/v1b3/dataflow-api.json @@ -265,7 +265,7 @@ ] }, "create": { - "description": "Creates a Cloud Dataflow job. To create a job, we recommend using `projects.locations.jobs.create` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.create` is not recommended, as your job will always start in `us-central1`.", + "description": "Creates a Cloud Dataflow job. To create a job, we recommend using `projects.locations.jobs.create` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.create` is not recommended, as your job will always start in `us-central1`. Do not enter confidential information when you supply string values using the API.", "flatPath": "v1b3/projects/{projectId}/jobs", "httpMethod": "POST", "id": "dataflow.projects.jobs.create", @@ -910,7 +910,7 @@ "jobs": { "methods": { "create": { - "description": "Creates a Cloud Dataflow job. To create a job, we recommend using `projects.locations.jobs.create` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.create` is not recommended, as your job will always start in `us-central1`.", + "description": "Creates a Cloud Dataflow job. To create a job, we recommend using `projects.locations.jobs.create` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.create` is not recommended, as your job will always start in `us-central1`. Do not enter confidential information when you supply string values using the API.", "flatPath": "v1b3/projects/{projectId}/locations/{location}/jobs", "httpMethod": "POST", "id": "dataflow.projects.locations.jobs.create", @@ -1858,7 +1858,7 @@ "templates": { "methods": { "create": { - "description": "Creates a Cloud Dataflow job from a template.", + "description": "Creates a Cloud Dataflow job from a template. Do not enter confidential information when you supply string values using the API.", "flatPath": "v1b3/projects/{projectId}/locations/{location}/templates", "httpMethod": "POST", "id": "dataflow.projects.locations.templates.create", @@ -2088,7 +2088,7 @@ "templates": { "methods": { "create": { - "description": "Creates a Cloud Dataflow job from a template.", + "description": "Creates a Cloud Dataflow job from a template. Do not enter confidential information when you supply string values using the API.", "flatPath": "v1b3/projects/{projectId}/templates", "httpMethod": "POST", "id": "dataflow.projects.templates.create", @@ -2225,7 +2225,7 @@ } } }, - "revision": "20220301", + "revision": "20220405", "rootUrl": "https://dataflow.googleapis.com/", "schemas": { "ApproximateProgress": { @@ -2541,6 +2541,18 @@ "description": "Name of the docker container image. E.g., gcr.io/project/some-image", "type": "string" }, + "imageRepositoryCertPath": { + "description": "Cloud Storage path to self-signed certificate of private registry.", + "type": "string" + }, + "imageRepositoryPasswordSecretId": { + "description": "Secret Manager secret id for password to authenticate to private registry.", + "type": "string" + }, + "imageRepositoryUsernameSecretId": { + "description": "Secret Manager secret id for username to authenticate to private registry.", + "type": "string" + }, "metadata": { "$ref": "TemplateMetadata", "description": "Metadata describing a template including description and validation rules." @@ -3666,7 +3678,7 @@ "type": "object" }, "Job": { - "description": "Defines a job to be run by the Cloud Dataflow service.", + "description": "Defines a job to be run by the Cloud Dataflow service. Do not enter confidential information when you supply string values using the API.", "id": "Job", "properties": { "clientRequestId": { @@ -4139,7 +4151,7 @@ "type": "object" }, "LaunchTemplateParameters": { - "description": "Parameters to provide to the template being launched.", + "description": "Parameters to provide to the template being launched. Note that the [metadata in the pipeline code] (https://cloud.google.com/dataflow/docs/guides/templates/creating-templates#metadata) determines which runtime parameters are valid.", "id": "LaunchTemplateParameters", "properties": { "environment": { @@ -5111,7 +5123,7 @@ "type": "string" }, "numWorkers": { - "description": "The initial number of Google Compute Engine instnaces for the job.", + "description": "The initial number of Google Compute Engine instances for the job.", "format": "int32", "type": "integer" }, diff --git a/dataflow/v1b3/dataflow-gen.go b/dataflow/v1b3/dataflow-gen.go index 92f464b4702..e8fab83799b 100644 --- a/dataflow/v1b3/dataflow-gen.go +++ b/dataflow/v1b3/dataflow-gen.go @@ -941,6 +941,18 @@ type ContainerSpec struct { // gcr.io/project/some-image Image string `json:"image,omitempty"` + // ImageRepositoryCertPath: Cloud Storage path to self-signed + // certificate of private registry. + ImageRepositoryCertPath string `json:"imageRepositoryCertPath,omitempty"` + + // ImageRepositoryPasswordSecretId: Secret Manager secret id for + // password to authenticate to private registry. + ImageRepositoryPasswordSecretId string `json:"imageRepositoryPasswordSecretId,omitempty"` + + // ImageRepositoryUsernameSecretId: Secret Manager secret id for + // username to authenticate to private registry. + ImageRepositoryUsernameSecretId string `json:"imageRepositoryUsernameSecretId,omitempty"` + // Metadata: Metadata describing a template including description and // validation rules. Metadata *TemplateMetadata `json:"metadata,omitempty"` @@ -2676,7 +2688,9 @@ func (s *IntegerMean) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// Job: Defines a job to be run by the Cloud Dataflow service. +// Job: Defines a job to be run by the Cloud Dataflow service. Do not +// enter confidential information when you supply string values using +// the API. type Job struct { // ClientRequestId: The client's unique identifier of the job, re-used // across retried attempts. If this field is set, the service will @@ -3427,7 +3441,9 @@ func (s *LaunchFlexTemplateResponse) MarshalJSON() ([]byte, error) { } // LaunchTemplateParameters: Parameters to provide to the template being -// launched. +// launched. Note that the [metadata in the pipeline code] +// (https://cloud.google.com/dataflow/docs/guides/templates/creating-templates#metadata) +// determines which runtime parameters are valid. type LaunchTemplateParameters struct { // Environment: The runtime environment for the job. Environment *RuntimeEnvironment `json:"environment,omitempty"` @@ -4943,7 +4959,7 @@ type RuntimeEnvironment struct { // unspecified, the service will use the network "default". Network string `json:"network,omitempty"` - // NumWorkers: The initial number of Google Compute Engine instnaces for + // NumWorkers: The initial number of Google Compute Engine instances for // the job. NumWorkers int64 `json:"numWorkers,omitempty"` @@ -8597,7 +8613,8 @@ type ProjectsJobsCreateCall struct { // using `projects.locations.jobs.create` with a [regional endpoint] // (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). // Using `projects.jobs.create` is not recommended, as your job will -// always start in `us-central1`. +// always start in `us-central1`. Do not enter confidential information +// when you supply string values using the API. // // - projectId: The ID of the Cloud Platform project that the job // belongs to. @@ -8733,7 +8750,7 @@ func (c *ProjectsJobsCreateCall) Do(opts ...googleapi.CallOption) (*Job, error) } return ret, nil // { - // "description": "Creates a Cloud Dataflow job. To create a job, we recommend using `projects.locations.jobs.create` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.create` is not recommended, as your job will always start in `us-central1`.", + // "description": "Creates a Cloud Dataflow job. To create a job, we recommend using `projects.locations.jobs.create` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.create` is not recommended, as your job will always start in `us-central1`. Do not enter confidential information when you supply string values using the API.", // "flatPath": "v1b3/projects/{projectId}/jobs", // "httpMethod": "POST", // "id": "dataflow.projects.jobs.create", @@ -11081,7 +11098,8 @@ type ProjectsLocationsJobsCreateCall struct { // using `projects.locations.jobs.create` with a [regional endpoint] // (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). // Using `projects.jobs.create` is not recommended, as your job will -// always start in `us-central1`. +// always start in `us-central1`. Do not enter confidential information +// when you supply string values using the API. // // - location: The [regional endpoint] // (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) @@ -11213,7 +11231,7 @@ func (c *ProjectsLocationsJobsCreateCall) Do(opts ...googleapi.CallOption) (*Job } return ret, nil // { - // "description": "Creates a Cloud Dataflow job. To create a job, we recommend using `projects.locations.jobs.create` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.create` is not recommended, as your job will always start in `us-central1`.", + // "description": "Creates a Cloud Dataflow job. To create a job, we recommend using `projects.locations.jobs.create` with a [regional endpoint] (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints). Using `projects.jobs.create` is not recommended, as your job will always start in `us-central1`. Do not enter confidential information when you supply string values using the API.", // "flatPath": "v1b3/projects/{projectId}/locations/{location}/jobs", // "httpMethod": "POST", // "id": "dataflow.projects.locations.jobs.create", @@ -14628,7 +14646,8 @@ type ProjectsLocationsTemplatesCreateCall struct { header_ http.Header } -// Create: Creates a Cloud Dataflow job from a template. +// Create: Creates a Cloud Dataflow job from a template. Do not enter +// confidential information when you supply string values using the API. // // - location: The [regional endpoint] // (https://cloud.google.com/dataflow/docs/concepts/regional-endpoints) @@ -14735,7 +14754,7 @@ func (c *ProjectsLocationsTemplatesCreateCall) Do(opts ...googleapi.CallOption) } return ret, nil // { - // "description": "Creates a Cloud Dataflow job from a template.", + // "description": "Creates a Cloud Dataflow job from a template. Do not enter confidential information when you supply string values using the API.", // "flatPath": "v1b3/projects/{projectId}/locations/{location}/templates", // "httpMethod": "POST", // "id": "dataflow.projects.locations.templates.create", @@ -15537,7 +15556,8 @@ type ProjectsTemplatesCreateCall struct { header_ http.Header } -// Create: Creates a Cloud Dataflow job from a template. +// Create: Creates a Cloud Dataflow job from a template. Do not enter +// confidential information when you supply string values using the API. // // - projectId: The ID of the Cloud Platform project that the job // belongs to. @@ -15639,7 +15659,7 @@ func (c *ProjectsTemplatesCreateCall) Do(opts ...googleapi.CallOption) (*Job, er } return ret, nil // { - // "description": "Creates a Cloud Dataflow job from a template.", + // "description": "Creates a Cloud Dataflow job from a template. Do not enter confidential information when you supply string values using the API.", // "flatPath": "v1b3/projects/{projectId}/templates", // "httpMethod": "POST", // "id": "dataflow.projects.templates.create", diff --git a/deploymentmanager/v0.alpha/deploymentmanager-api.json b/deploymentmanager/v0.alpha/deploymentmanager-api.json index a7dded0d3c5..856d18c9380 100644 --- a/deploymentmanager/v0.alpha/deploymentmanager-api.json +++ b/deploymentmanager/v0.alpha/deploymentmanager-api.json @@ -1588,7 +1588,7 @@ } } }, - "revision": "20220303", + "revision": "20220407", "rootUrl": "https://deploymentmanager.googleapis.com/", "schemas": { "AsyncOptions": { @@ -1702,7 +1702,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" }, diff --git a/deploymentmanager/v0.alpha/deploymentmanager-gen.go b/deploymentmanager/v0.alpha/deploymentmanager-gen.go index 858c06d6d40..1381971d5b0 100644 --- a/deploymentmanager/v0.alpha/deploymentmanager-gen.go +++ b/deploymentmanager/v0.alpha/deploymentmanager-gen.go @@ -449,8 +449,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 diff --git a/deploymentmanager/v2/deploymentmanager-api.json b/deploymentmanager/v2/deploymentmanager-api.json index afab67bac27..fdca5656afb 100644 --- a/deploymentmanager/v2/deploymentmanager-api.json +++ b/deploymentmanager/v2/deploymentmanager-api.json @@ -988,7 +988,7 @@ } } }, - "revision": "20220303", + "revision": "20220407", "rootUrl": "https://deploymentmanager.googleapis.com/", "schemas": { "AuditConfig": { @@ -1048,7 +1048,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" }, diff --git a/deploymentmanager/v2/deploymentmanager-gen.go b/deploymentmanager/v2/deploymentmanager-gen.go index dc45481b01b..90a398e8602 100644 --- a/deploymentmanager/v2/deploymentmanager-gen.go +++ b/deploymentmanager/v2/deploymentmanager-gen.go @@ -322,8 +322,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 diff --git a/deploymentmanager/v2beta/deploymentmanager-api.json b/deploymentmanager/v2beta/deploymentmanager-api.json index 6f59d7ea3a7..b76659026ca 100644 --- a/deploymentmanager/v2beta/deploymentmanager-api.json +++ b/deploymentmanager/v2beta/deploymentmanager-api.json @@ -1552,7 +1552,7 @@ } } }, - "revision": "20220303", + "revision": "20220407", "rootUrl": "https://deploymentmanager.googleapis.com/", "schemas": { "AsyncOptions": { @@ -1666,7 +1666,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" }, diff --git a/deploymentmanager/v2beta/deploymentmanager-gen.go b/deploymentmanager/v2beta/deploymentmanager-gen.go index d5e42284b86..0b3ed862749 100644 --- a/deploymentmanager/v2beta/deploymentmanager-gen.go +++ b/deploymentmanager/v2beta/deploymentmanager-gen.go @@ -449,8 +449,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 diff --git a/drive/v2/drive-api.json b/drive/v2/drive-api.json index 03513b14a7e..d35080f7e23 100644 --- a/drive/v2/drive-api.json +++ b/drive/v2/drive-api.json @@ -38,7 +38,7 @@ "description": "Manages files in Drive including uploading, downloading, searching, detecting changes, and updating sharing permissions.", "discoveryVersion": "v1", "documentationLink": "https://developers.google.com/drive/", - "etag": "\"uWj2hSb4GVjzdDlAnRd2gbM1ZQ8/fyRiAs3KSL24dYObYzBvDUCJFvw\"", + "etag": "\"uWj2hSb4GVjzdDlAnRd2gbM1ZQ8/TpIVFqF0vX0A00kEkuvQ2oYAYm0\"", "icons": { "x16": "https://ssl.gstatic.com/docs/doclist/images/drive_icon_16.png", "x32": "https://ssl.gstatic.com/docs/doclist/images/drive_icon_32.png" @@ -2090,7 +2090,7 @@ "supportsMediaUpload": true }, "watch": { - "description": "Subscribe to changes on a file", + "description": "Subscribes to changes to a file. While you can establish a channel for changes to a file on a shared drive, a change to a shared drive file won't create a notification.", "httpMethod": "POST", "id": "drive.files.watch", "parameterOrder": [ @@ -3527,7 +3527,7 @@ } } }, - "revision": "20220110", + "revision": "20220410", "rootUrl": "https://www.googleapis.com/", "schemas": { "About": { diff --git a/drive/v2/drive-gen.go b/drive/v2/drive-gen.go index eea9892c128..9466415eae9 100644 --- a/drive/v2/drive-gen.go +++ b/drive/v2/drive-gen.go @@ -11752,7 +11752,9 @@ type FilesWatchCall struct { header_ http.Header } -// Watch: Subscribe to changes on a file +// Watch: Subscribes to changes to a file. While you can establish a +// channel for changes to a file on a shared drive, a change to a shared +// drive file won't create a notification. // // - fileId: The ID for the file in question. func (r *FilesService) Watch(fileId string, channel *Channel) *FilesWatchCall { @@ -11928,7 +11930,7 @@ func (c *FilesWatchCall) Do(opts ...googleapi.CallOption) (*Channel, error) { } return ret, nil // { - // "description": "Subscribe to changes on a file", + // "description": "Subscribes to changes to a file. While you can establish a channel for changes to a file on a shared drive, a change to a shared drive file won't create a notification.", // "httpMethod": "POST", // "id": "drive.files.watch", // "parameterOrder": [ diff --git a/drive/v3/drive-api.json b/drive/v3/drive-api.json index 2cd4b0b6a7c..a9d8fe75c48 100644 --- a/drive/v3/drive-api.json +++ b/drive/v3/drive-api.json @@ -35,7 +35,7 @@ "description": "Manages files in Drive including uploading, downloading, searching, detecting changes, and updating sharing permissions.", "discoveryVersion": "v1", "documentationLink": "https://developers.google.com/drive/", - "etag": "\"uWj2hSb4GVjzdDlAnRd2gbM1ZQ8/74PJlywo-WsTK0zBGn4AI7FrihI\"", + "etag": "\"uWj2hSb4GVjzdDlAnRd2gbM1ZQ8/5PAnsVf9DiU_j92nDdFVDayKgEo\"", "icons": { "x16": "https://ssl.gstatic.com/docs/doclist/images/drive_icon_16.png", "x32": "https://ssl.gstatic.com/docs/doclist/images/drive_icon_32.png" @@ -1308,7 +1308,7 @@ "supportsMediaUpload": true }, "watch": { - "description": "Subscribes to changes to a file. While you can establish a channel forchanges to a file on a shared drive, a change to a shared drive file won't create a notification.", + "description": "Subscribes to changes to a file. While you can establish a channel for changes to a file on a shared drive, a change to a shared drive file won't create a notification.", "httpMethod": "POST", "id": "drive.files.watch", "parameterOrder": [ @@ -2191,7 +2191,7 @@ } } }, - "revision": "20220214", + "revision": "20220410", "rootUrl": "https://www.googleapis.com/", "schemas": { "About": { diff --git a/drive/v3/drive-gen.go b/drive/v3/drive-gen.go index 683603194e3..9b53e4502b5 100644 --- a/drive/v3/drive-gen.go +++ b/drive/v3/drive-gen.go @@ -8020,7 +8020,7 @@ type FilesWatchCall struct { } // Watch: Subscribes to changes to a file. While you can establish a -// channel forchanges to a file on a shared drive, a change to a shared +// channel for changes to a file on a shared drive, a change to a shared // drive file won't create a notification. // // - fileId: The ID of the file. @@ -8171,7 +8171,7 @@ func (c *FilesWatchCall) Do(opts ...googleapi.CallOption) (*Channel, error) { } return ret, nil // { - // "description": "Subscribes to changes to a file. While you can establish a channel forchanges to a file on a shared drive, a change to a shared drive file won't create a notification.", + // "description": "Subscribes to changes to a file. While you can establish a channel for changes to a file on a shared drive, a change to a shared drive file won't create a notification.", // "httpMethod": "POST", // "id": "drive.files.watch", // "parameterOrder": [ diff --git a/healthcare/v1/healthcare-api.json b/healthcare/v1/healthcare-api.json index b74304391f7..c1d25467648 100644 --- a/healthcare/v1/healthcare-api.json +++ b/healthcare/v1/healthcare-api.json @@ -4053,7 +4053,7 @@ } } }, - "revision": "20220224", + "revision": "20220404", "rootUrl": "https://healthcare.googleapis.com/", "schemas": { "ActivateConsentRequest": { @@ -4739,7 +4739,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/healthcare/v1/healthcare-gen.go b/healthcare/v1/healthcare-gen.go index 972e1db3328..aa56d23e483 100644 --- a/healthcare/v1/healthcare-gen.go +++ b/healthcare/v1/healthcare-gen.go @@ -1677,8 +1677,7 @@ func (s *DicomStore) 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. diff --git a/healthcare/v1beta1/healthcare-api.json b/healthcare/v1beta1/healthcare-api.json index 435baa98858..1085a49062d 100644 --- a/healthcare/v1beta1/healthcare-api.json +++ b/healthcare/v1beta1/healthcare-api.json @@ -4865,7 +4865,7 @@ } } }, - "revision": "20220317", + "revision": "20220404", "rootUrl": "https://healthcare.googleapis.com/", "schemas": { "ActivateConsentRequest": { @@ -5749,7 +5749,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/healthcare/v1beta1/healthcare-gen.go b/healthcare/v1beta1/healthcare-gen.go index c7ff101b64c..a1757a85b47 100644 --- a/healthcare/v1beta1/healthcare-gen.go +++ b/healthcare/v1beta1/healthcare-gen.go @@ -2112,8 +2112,7 @@ func (s *DicomStore) 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. diff --git a/logging/v2/logging-api.json b/logging/v2/logging-api.json index d69542ba3fa..fc9cf5fe950 100644 --- a/logging/v2/logging-api.json +++ b/logging/v2/logging-api.json @@ -783,6 +783,57 @@ "https://www.googleapis.com/auth/logging.admin" ] } + }, + "resources": { + "logs": { + "methods": { + "list": { + "description": "Lists the logs in projects, organizations, folders, or billing accounts. Only logs that have entries are listed.", + "flatPath": "v2/billingAccounts/{billingAccountsId}/locations/{locationsId}/buckets/{bucketsId}/views/{viewsId}/logs", + "httpMethod": "GET", + "id": "logging.billingAccounts.locations.buckets.views.logs.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The resource name that owns the logs: projects/[PROJECT_ID] organizations/[ORGANIZATION_ID] billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID]", + "location": "path", + "pattern": "^billingAccounts/[^/]+/locations/[^/]+/buckets/[^/]+/views/[^/]+$", + "required": true, + "type": "string" + }, + "resourceNames": { + "description": "Optional. The resource name that owns the logs: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]To support legacy queries, it could also be: projects/[PROJECT_ID] organizations/[ORGANIZATION_ID] billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID]", + "location": "query", + "repeated": true, + "type": "string" + } + }, + "path": "v2/{+parent}/logs", + "response": { + "$ref": "ListLogsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only", + "https://www.googleapis.com/auth/logging.admin", + "https://www.googleapis.com/auth/logging.read" + ] + } + } + } } } } @@ -2123,6 +2174,57 @@ "https://www.googleapis.com/auth/logging.admin" ] } + }, + "resources": { + "logs": { + "methods": { + "list": { + "description": "Lists the logs in projects, organizations, folders, or billing accounts. Only logs that have entries are listed.", + "flatPath": "v2/folders/{foldersId}/locations/{locationsId}/buckets/{bucketsId}/views/{viewsId}/logs", + "httpMethod": "GET", + "id": "logging.folders.locations.buckets.views.logs.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The resource name that owns the logs: projects/[PROJECT_ID] organizations/[ORGANIZATION_ID] billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID]", + "location": "path", + "pattern": "^folders/[^/]+/locations/[^/]+/buckets/[^/]+/views/[^/]+$", + "required": true, + "type": "string" + }, + "resourceNames": { + "description": "Optional. The resource name that owns the logs: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]To support legacy queries, it could also be: projects/[PROJECT_ID] organizations/[ORGANIZATION_ID] billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID]", + "location": "query", + "repeated": true, + "type": "string" + } + }, + "path": "v2/{+parent}/logs", + "response": { + "$ref": "ListLogsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only", + "https://www.googleapis.com/auth/logging.admin", + "https://www.googleapis.com/auth/logging.read" + ] + } + } + } } } } @@ -3903,6 +4005,57 @@ "https://www.googleapis.com/auth/logging.admin" ] } + }, + "resources": { + "logs": { + "methods": { + "list": { + "description": "Lists the logs in projects, organizations, folders, or billing accounts. Only logs that have entries are listed.", + "flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/buckets/{bucketsId}/views/{viewsId}/logs", + "httpMethod": "GET", + "id": "logging.organizations.locations.buckets.views.logs.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The resource name that owns the logs: projects/[PROJECT_ID] organizations/[ORGANIZATION_ID] billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID]", + "location": "path", + "pattern": "^organizations/[^/]+/locations/[^/]+/buckets/[^/]+/views/[^/]+$", + "required": true, + "type": "string" + }, + "resourceNames": { + "description": "Optional. The resource name that owns the logs: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]To support legacy queries, it could also be: projects/[PROJECT_ID] organizations/[ORGANIZATION_ID] billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID]", + "location": "query", + "repeated": true, + "type": "string" + } + }, + "path": "v2/{+parent}/logs", + "response": { + "$ref": "ListLogsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only", + "https://www.googleapis.com/auth/logging.admin", + "https://www.googleapis.com/auth/logging.read" + ] + } + } + } } } } @@ -4958,6 +5111,57 @@ "https://www.googleapis.com/auth/logging.admin" ] } + }, + "resources": { + "logs": { + "methods": { + "list": { + "description": "Lists the logs in projects, organizations, folders, or billing accounts. Only logs that have entries are listed.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/buckets/{bucketsId}/views/{viewsId}/logs", + "httpMethod": "GET", + "id": "logging.projects.locations.buckets.views.logs.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. The resource name that owns the logs: projects/[PROJECT_ID] organizations/[ORGANIZATION_ID] billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID]", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/buckets/[^/]+/views/[^/]+$", + "required": true, + "type": "string" + }, + "resourceNames": { + "description": "Optional. The resource name that owns the logs: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]To support legacy queries, it could also be: projects/[PROJECT_ID] organizations/[ORGANIZATION_ID] billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID]", + "location": "query", + "repeated": true, + "type": "string" + } + }, + "path": "v2/{+parent}/logs", + "response": { + "$ref": "ListLogsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/cloud-platform.read-only", + "https://www.googleapis.com/auth/logging.admin", + "https://www.googleapis.com/auth/logging.read" + ] + } + } + } } } } @@ -5817,7 +6021,7 @@ } } }, - "revision": "20220401", + "revision": "20220408", "rootUrl": "https://logging.googleapis.com/", "schemas": { "BigQueryOptions": { diff --git a/logging/v2/logging-gen.go b/logging/v2/logging-gen.go index dd0568de666..a620bcb6dbb 100644 --- a/logging/v2/logging-gen.go +++ b/logging/v2/logging-gen.go @@ -276,11 +276,23 @@ type BillingAccountsLocationsBucketsService struct { func NewBillingAccountsLocationsBucketsViewsService(s *Service) *BillingAccountsLocationsBucketsViewsService { rs := &BillingAccountsLocationsBucketsViewsService{s: s} + rs.Logs = NewBillingAccountsLocationsBucketsViewsLogsService(s) return rs } type BillingAccountsLocationsBucketsViewsService struct { s *Service + + Logs *BillingAccountsLocationsBucketsViewsLogsService +} + +func NewBillingAccountsLocationsBucketsViewsLogsService(s *Service) *BillingAccountsLocationsBucketsViewsLogsService { + rs := &BillingAccountsLocationsBucketsViewsLogsService{s: s} + return rs +} + +type BillingAccountsLocationsBucketsViewsLogsService struct { + s *Service } func NewBillingAccountsLocationsOperationsService(s *Service) *BillingAccountsLocationsOperationsService { @@ -396,11 +408,23 @@ type FoldersLocationsBucketsService struct { func NewFoldersLocationsBucketsViewsService(s *Service) *FoldersLocationsBucketsViewsService { rs := &FoldersLocationsBucketsViewsService{s: s} + rs.Logs = NewFoldersLocationsBucketsViewsLogsService(s) return rs } type FoldersLocationsBucketsViewsService struct { s *Service + + Logs *FoldersLocationsBucketsViewsLogsService +} + +func NewFoldersLocationsBucketsViewsLogsService(s *Service) *FoldersLocationsBucketsViewsLogsService { + rs := &FoldersLocationsBucketsViewsLogsService{s: s} + return rs +} + +type FoldersLocationsBucketsViewsLogsService struct { + s *Service } func NewFoldersLocationsOperationsService(s *Service) *FoldersLocationsOperationsService { @@ -552,11 +576,23 @@ type OrganizationsLocationsBucketsService struct { func NewOrganizationsLocationsBucketsViewsService(s *Service) *OrganizationsLocationsBucketsViewsService { rs := &OrganizationsLocationsBucketsViewsService{s: s} + rs.Logs = NewOrganizationsLocationsBucketsViewsLogsService(s) return rs } type OrganizationsLocationsBucketsViewsService struct { s *Service + + Logs *OrganizationsLocationsBucketsViewsLogsService +} + +func NewOrganizationsLocationsBucketsViewsLogsService(s *Service) *OrganizationsLocationsBucketsViewsLogsService { + rs := &OrganizationsLocationsBucketsViewsLogsService{s: s} + return rs +} + +type OrganizationsLocationsBucketsViewsLogsService struct { + s *Service } func NewOrganizationsLocationsOperationsService(s *Service) *OrganizationsLocationsOperationsService { @@ -648,11 +684,23 @@ type ProjectsLocationsBucketsService struct { func NewProjectsLocationsBucketsViewsService(s *Service) *ProjectsLocationsBucketsViewsService { rs := &ProjectsLocationsBucketsViewsService{s: s} + rs.Logs = NewProjectsLocationsBucketsViewsLogsService(s) return rs } type ProjectsLocationsBucketsViewsService struct { s *Service + + Logs *ProjectsLocationsBucketsViewsLogsService +} + +func NewProjectsLocationsBucketsViewsLogsService(s *Service) *ProjectsLocationsBucketsViewsLogsService { + rs := &ProjectsLocationsBucketsViewsLogsService{s: s} + return rs +} + +type ProjectsLocationsBucketsViewsLogsService struct { + s *Service } func NewProjectsLocationsOperationsService(s *Service) *ProjectsLocationsOperationsService { @@ -7112,6 +7160,232 @@ func (c *BillingAccountsLocationsBucketsViewsPatchCall) Do(opts ...googleapi.Cal } +// method id "logging.billingAccounts.locations.buckets.views.logs.list": + +type BillingAccountsLocationsBucketsViewsLogsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists the logs in projects, organizations, folders, or billing +// accounts. Only logs that have entries are listed. +// +// - parent: The resource name that owns the logs: projects/[PROJECT_ID] +// organizations/[ORGANIZATION_ID] +// billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID]. +func (r *BillingAccountsLocationsBucketsViewsLogsService) List(parent string) *BillingAccountsLocationsBucketsViewsLogsListCall { + c := &BillingAccountsLocationsBucketsViewsLogsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number +// of results to return from this request. Non-positive values are +// ignored. The presence of nextPageToken in the response indicates that +// more results might be available. +func (c *BillingAccountsLocationsBucketsViewsLogsListCall) PageSize(pageSize int64) *BillingAccountsLocationsBucketsViewsLogsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": If present, then +// retrieve the next batch of results from the preceding call to this +// method. pageToken must be the value of nextPageToken from the +// previous response. The values of other method parameters should be +// identical to those in the previous call. +func (c *BillingAccountsLocationsBucketsViewsLogsListCall) PageToken(pageToken string) *BillingAccountsLocationsBucketsViewsLogsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// ResourceNames sets the optional parameter "resourceNames": The +// resource name that owns the logs: +// projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/view +// s/[VIEW_ID] +// organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKE +// T_ID]/views/[VIEW_ID] +// billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[ +// BUCKET_ID]/views/[VIEW_ID] +// folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/ +// [VIEW_ID]To support legacy queries, it could also be: +// projects/[PROJECT_ID] organizations/[ORGANIZATION_ID] +// billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID] +func (c *BillingAccountsLocationsBucketsViewsLogsListCall) ResourceNames(resourceNames ...string) *BillingAccountsLocationsBucketsViewsLogsListCall { + c.urlParams_.SetMulti("resourceNames", append([]string{}, resourceNames...)) + 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 *BillingAccountsLocationsBucketsViewsLogsListCall) Fields(s ...googleapi.Field) *BillingAccountsLocationsBucketsViewsLogsListCall { + 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 *BillingAccountsLocationsBucketsViewsLogsListCall) IfNoneMatch(entityTag string) *BillingAccountsLocationsBucketsViewsLogsListCall { + 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 *BillingAccountsLocationsBucketsViewsLogsListCall) Context(ctx context.Context) *BillingAccountsLocationsBucketsViewsLogsListCall { + 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 *BillingAccountsLocationsBucketsViewsLogsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *BillingAccountsLocationsBucketsViewsLogsListCall) 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}/logs") + 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 "logging.billingAccounts.locations.buckets.views.logs.list" call. +// Exactly one of *ListLogsResponse or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *ListLogsResponse.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 *BillingAccountsLocationsBucketsViewsLogsListCall) Do(opts ...googleapi.CallOption) (*ListLogsResponse, 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 := &ListLogsResponse{ + 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 the logs in projects, organizations, folders, or billing accounts. Only logs that have entries are listed.", + // "flatPath": "v2/billingAccounts/{billingAccountsId}/locations/{locationsId}/buckets/{bucketsId}/views/{viewsId}/logs", + // "httpMethod": "GET", + // "id": "logging.billingAccounts.locations.buckets.views.logs.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "pageSize": { + // "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The resource name that owns the logs: projects/[PROJECT_ID] organizations/[ORGANIZATION_ID] billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID]", + // "location": "path", + // "pattern": "^billingAccounts/[^/]+/locations/[^/]+/buckets/[^/]+/views/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "resourceNames": { + // "description": "Optional. The resource name that owns the logs: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]To support legacy queries, it could also be: projects/[PROJECT_ID] organizations/[ORGANIZATION_ID] billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID]", + // "location": "query", + // "repeated": true, + // "type": "string" + // } + // }, + // "path": "v2/{+parent}/logs", + // "response": { + // "$ref": "ListLogsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/cloud-platform.read-only", + // "https://www.googleapis.com/auth/logging.admin", + // "https://www.googleapis.com/auth/logging.read" + // ] + // } + +} + +// 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 *BillingAccountsLocationsBucketsViewsLogsListCall) Pages(ctx context.Context, f func(*ListLogsResponse) 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 "logging.billingAccounts.locations.operations.cancel": type BillingAccountsLocationsOperationsCancelCall struct { @@ -13897,22 +14171,248 @@ func (c *FoldersLocationsBucketsViewsPatchCall) Do(opts ...googleapi.CallOption) } -// method id "logging.folders.locations.operations.cancel": +// method id "logging.folders.locations.buckets.views.logs.list": -type FoldersLocationsOperationsCancelCall struct { - s *Service - name string - canceloperationrequest *CancelOperationRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type FoldersLocationsBucketsViewsLogsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Cancel: Starts asynchronous cancellation on a long-running operation. -// The server makes a best effort to cancel the operation, but success -// is not guaranteed. If the server doesn't support this method, it -// returns google.rpc.Code.UNIMPLEMENTED. Clients can use -// Operations.GetOperation or other methods to check whether the +// List: Lists the logs in projects, organizations, folders, or billing +// accounts. Only logs that have entries are listed. +// +// - parent: The resource name that owns the logs: projects/[PROJECT_ID] +// organizations/[ORGANIZATION_ID] +// billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID]. +func (r *FoldersLocationsBucketsViewsLogsService) List(parent string) *FoldersLocationsBucketsViewsLogsListCall { + c := &FoldersLocationsBucketsViewsLogsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number +// of results to return from this request. Non-positive values are +// ignored. The presence of nextPageToken in the response indicates that +// more results might be available. +func (c *FoldersLocationsBucketsViewsLogsListCall) PageSize(pageSize int64) *FoldersLocationsBucketsViewsLogsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": If present, then +// retrieve the next batch of results from the preceding call to this +// method. pageToken must be the value of nextPageToken from the +// previous response. The values of other method parameters should be +// identical to those in the previous call. +func (c *FoldersLocationsBucketsViewsLogsListCall) PageToken(pageToken string) *FoldersLocationsBucketsViewsLogsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// ResourceNames sets the optional parameter "resourceNames": The +// resource name that owns the logs: +// projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/view +// s/[VIEW_ID] +// organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKE +// T_ID]/views/[VIEW_ID] +// billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[ +// BUCKET_ID]/views/[VIEW_ID] +// folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/ +// [VIEW_ID]To support legacy queries, it could also be: +// projects/[PROJECT_ID] organizations/[ORGANIZATION_ID] +// billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID] +func (c *FoldersLocationsBucketsViewsLogsListCall) ResourceNames(resourceNames ...string) *FoldersLocationsBucketsViewsLogsListCall { + c.urlParams_.SetMulti("resourceNames", append([]string{}, resourceNames...)) + 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 *FoldersLocationsBucketsViewsLogsListCall) Fields(s ...googleapi.Field) *FoldersLocationsBucketsViewsLogsListCall { + 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 *FoldersLocationsBucketsViewsLogsListCall) IfNoneMatch(entityTag string) *FoldersLocationsBucketsViewsLogsListCall { + 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 *FoldersLocationsBucketsViewsLogsListCall) Context(ctx context.Context) *FoldersLocationsBucketsViewsLogsListCall { + 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 *FoldersLocationsBucketsViewsLogsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *FoldersLocationsBucketsViewsLogsListCall) 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}/logs") + 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 "logging.folders.locations.buckets.views.logs.list" call. +// Exactly one of *ListLogsResponse or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *ListLogsResponse.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 *FoldersLocationsBucketsViewsLogsListCall) Do(opts ...googleapi.CallOption) (*ListLogsResponse, 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 := &ListLogsResponse{ + 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 the logs in projects, organizations, folders, or billing accounts. Only logs that have entries are listed.", + // "flatPath": "v2/folders/{foldersId}/locations/{locationsId}/buckets/{bucketsId}/views/{viewsId}/logs", + // "httpMethod": "GET", + // "id": "logging.folders.locations.buckets.views.logs.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "pageSize": { + // "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The resource name that owns the logs: projects/[PROJECT_ID] organizations/[ORGANIZATION_ID] billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID]", + // "location": "path", + // "pattern": "^folders/[^/]+/locations/[^/]+/buckets/[^/]+/views/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "resourceNames": { + // "description": "Optional. The resource name that owns the logs: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]To support legacy queries, it could also be: projects/[PROJECT_ID] organizations/[ORGANIZATION_ID] billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID]", + // "location": "query", + // "repeated": true, + // "type": "string" + // } + // }, + // "path": "v2/{+parent}/logs", + // "response": { + // "$ref": "ListLogsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/cloud-platform.read-only", + // "https://www.googleapis.com/auth/logging.admin", + // "https://www.googleapis.com/auth/logging.read" + // ] + // } + +} + +// 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 *FoldersLocationsBucketsViewsLogsListCall) Pages(ctx context.Context, f func(*ListLogsResponse) 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 "logging.folders.locations.operations.cancel": + +type FoldersLocationsOperationsCancelCall struct { + s *Service + name string + canceloperationrequest *CancelOperationRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Cancel: Starts asynchronous cancellation on a long-running operation. +// The server makes a best effort to cancel the operation, but success +// is not guaranteed. If the server doesn't support this method, it +// returns google.rpc.Code.UNIMPLEMENTED. Clients can use +// Operations.GetOperation or other methods to check whether the // cancellation succeeded or whether the operation completed despite // cancellation. On successful cancellation, the operation is not // deleted; instead, it becomes an operation with an Operation.error @@ -22761,41 +23261,267 @@ func (c *OrganizationsLocationsBucketsViewsPatchCall) Do(opts ...googleapi.CallO } -// method id "logging.organizations.locations.operations.cancel": +// method id "logging.organizations.locations.buckets.views.logs.list": -type OrganizationsLocationsOperationsCancelCall struct { - s *Service - name string - canceloperationrequest *CancelOperationRequest - urlParams_ gensupport.URLParams - ctx_ context.Context - header_ http.Header +type OrganizationsLocationsBucketsViewsLogsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header } -// Cancel: Starts asynchronous cancellation on a long-running operation. -// The server makes a best effort to cancel the operation, but success -// is not guaranteed. If the server doesn't support this method, it -// returns google.rpc.Code.UNIMPLEMENTED. Clients can use -// Operations.GetOperation or other methods to check whether the -// cancellation succeeded or whether the operation completed despite -// cancellation. On successful cancellation, the operation is not -// deleted; instead, it becomes an operation with an Operation.error -// value with a google.rpc.Status.code of 1, corresponding to -// Code.CANCELLED. +// List: Lists the logs in projects, organizations, folders, or billing +// accounts. Only logs that have entries are listed. // -// - name: The name of the operation resource to be cancelled. -func (r *OrganizationsLocationsOperationsService) Cancel(name string, canceloperationrequest *CancelOperationRequest) *OrganizationsLocationsOperationsCancelCall { - c := &OrganizationsLocationsOperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} - c.name = name - c.canceloperationrequest = canceloperationrequest +// - parent: The resource name that owns the logs: projects/[PROJECT_ID] +// organizations/[ORGANIZATION_ID] +// billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID]. +func (r *OrganizationsLocationsBucketsViewsLogsService) List(parent string) *OrganizationsLocationsBucketsViewsLogsListCall { + c := &OrganizationsLocationsBucketsViewsLogsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent 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 *OrganizationsLocationsOperationsCancelCall) Fields(s ...googleapi.Field) *OrganizationsLocationsOperationsCancelCall { - c.urlParams_.Set("fields", googleapi.CombineFields(s)) +// PageSize sets the optional parameter "pageSize": The maximum number +// of results to return from this request. Non-positive values are +// ignored. The presence of nextPageToken in the response indicates that +// more results might be available. +func (c *OrganizationsLocationsBucketsViewsLogsListCall) PageSize(pageSize int64) *OrganizationsLocationsBucketsViewsLogsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": If present, then +// retrieve the next batch of results from the preceding call to this +// method. pageToken must be the value of nextPageToken from the +// previous response. The values of other method parameters should be +// identical to those in the previous call. +func (c *OrganizationsLocationsBucketsViewsLogsListCall) PageToken(pageToken string) *OrganizationsLocationsBucketsViewsLogsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// ResourceNames sets the optional parameter "resourceNames": The +// resource name that owns the logs: +// projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/view +// s/[VIEW_ID] +// organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKE +// T_ID]/views/[VIEW_ID] +// billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[ +// BUCKET_ID]/views/[VIEW_ID] +// folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/ +// [VIEW_ID]To support legacy queries, it could also be: +// projects/[PROJECT_ID] organizations/[ORGANIZATION_ID] +// billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID] +func (c *OrganizationsLocationsBucketsViewsLogsListCall) ResourceNames(resourceNames ...string) *OrganizationsLocationsBucketsViewsLogsListCall { + c.urlParams_.SetMulti("resourceNames", append([]string{}, resourceNames...)) + 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 *OrganizationsLocationsBucketsViewsLogsListCall) Fields(s ...googleapi.Field) *OrganizationsLocationsBucketsViewsLogsListCall { + 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 *OrganizationsLocationsBucketsViewsLogsListCall) IfNoneMatch(entityTag string) *OrganizationsLocationsBucketsViewsLogsListCall { + 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 *OrganizationsLocationsBucketsViewsLogsListCall) Context(ctx context.Context) *OrganizationsLocationsBucketsViewsLogsListCall { + 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 *OrganizationsLocationsBucketsViewsLogsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *OrganizationsLocationsBucketsViewsLogsListCall) 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}/logs") + 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 "logging.organizations.locations.buckets.views.logs.list" call. +// Exactly one of *ListLogsResponse or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *ListLogsResponse.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 *OrganizationsLocationsBucketsViewsLogsListCall) Do(opts ...googleapi.CallOption) (*ListLogsResponse, 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 := &ListLogsResponse{ + 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 the logs in projects, organizations, folders, or billing accounts. Only logs that have entries are listed.", + // "flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/buckets/{bucketsId}/views/{viewsId}/logs", + // "httpMethod": "GET", + // "id": "logging.organizations.locations.buckets.views.logs.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "pageSize": { + // "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The resource name that owns the logs: projects/[PROJECT_ID] organizations/[ORGANIZATION_ID] billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID]", + // "location": "path", + // "pattern": "^organizations/[^/]+/locations/[^/]+/buckets/[^/]+/views/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "resourceNames": { + // "description": "Optional. The resource name that owns the logs: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]To support legacy queries, it could also be: projects/[PROJECT_ID] organizations/[ORGANIZATION_ID] billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID]", + // "location": "query", + // "repeated": true, + // "type": "string" + // } + // }, + // "path": "v2/{+parent}/logs", + // "response": { + // "$ref": "ListLogsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/cloud-platform.read-only", + // "https://www.googleapis.com/auth/logging.admin", + // "https://www.googleapis.com/auth/logging.read" + // ] + // } + +} + +// 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 *OrganizationsLocationsBucketsViewsLogsListCall) Pages(ctx context.Context, f func(*ListLogsResponse) 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 "logging.organizations.locations.operations.cancel": + +type OrganizationsLocationsOperationsCancelCall struct { + s *Service + name string + canceloperationrequest *CancelOperationRequest + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Cancel: Starts asynchronous cancellation on a long-running operation. +// The server makes a best effort to cancel the operation, but success +// is not guaranteed. If the server doesn't support this method, it +// returns google.rpc.Code.UNIMPLEMENTED. Clients can use +// Operations.GetOperation or other methods to check whether the +// cancellation succeeded or whether the operation completed despite +// cancellation. On successful cancellation, the operation is not +// deleted; instead, it becomes an operation with an Operation.error +// value with a google.rpc.Status.code of 1, corresponding to +// Code.CANCELLED. +// +// - name: The name of the operation resource to be cancelled. +func (r *OrganizationsLocationsOperationsService) Cancel(name string, canceloperationrequest *CancelOperationRequest) *OrganizationsLocationsOperationsCancelCall { + c := &OrganizationsLocationsOperationsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.canceloperationrequest = canceloperationrequest + 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 *OrganizationsLocationsOperationsCancelCall) Fields(s ...googleapi.Field) *OrganizationsLocationsOperationsCancelCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) return c } @@ -28021,6 +28747,232 @@ func (c *ProjectsLocationsBucketsViewsPatchCall) Do(opts ...googleapi.CallOption } +// method id "logging.projects.locations.buckets.views.logs.list": + +type ProjectsLocationsBucketsViewsLogsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: Lists the logs in projects, organizations, folders, or billing +// accounts. Only logs that have entries are listed. +// +// - parent: The resource name that owns the logs: projects/[PROJECT_ID] +// organizations/[ORGANIZATION_ID] +// billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID]. +func (r *ProjectsLocationsBucketsViewsLogsService) List(parent string) *ProjectsLocationsBucketsViewsLogsListCall { + c := &ProjectsLocationsBucketsViewsLogsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": The maximum number +// of results to return from this request. Non-positive values are +// ignored. The presence of nextPageToken in the response indicates that +// more results might be available. +func (c *ProjectsLocationsBucketsViewsLogsListCall) PageSize(pageSize int64) *ProjectsLocationsBucketsViewsLogsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": If present, then +// retrieve the next batch of results from the preceding call to this +// method. pageToken must be the value of nextPageToken from the +// previous response. The values of other method parameters should be +// identical to those in the previous call. +func (c *ProjectsLocationsBucketsViewsLogsListCall) PageToken(pageToken string) *ProjectsLocationsBucketsViewsLogsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// ResourceNames sets the optional parameter "resourceNames": The +// resource name that owns the logs: +// projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/view +// s/[VIEW_ID] +// organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKE +// T_ID]/views/[VIEW_ID] +// billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[ +// BUCKET_ID]/views/[VIEW_ID] +// folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/ +// [VIEW_ID]To support legacy queries, it could also be: +// projects/[PROJECT_ID] organizations/[ORGANIZATION_ID] +// billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID] +func (c *ProjectsLocationsBucketsViewsLogsListCall) ResourceNames(resourceNames ...string) *ProjectsLocationsBucketsViewsLogsListCall { + c.urlParams_.SetMulti("resourceNames", append([]string{}, resourceNames...)) + 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 *ProjectsLocationsBucketsViewsLogsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsBucketsViewsLogsListCall { + 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 *ProjectsLocationsBucketsViewsLogsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsBucketsViewsLogsListCall { + 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 *ProjectsLocationsBucketsViewsLogsListCall) Context(ctx context.Context) *ProjectsLocationsBucketsViewsLogsListCall { + 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 *ProjectsLocationsBucketsViewsLogsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsBucketsViewsLogsListCall) 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}/logs") + 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 "logging.projects.locations.buckets.views.logs.list" call. +// Exactly one of *ListLogsResponse or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *ListLogsResponse.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 *ProjectsLocationsBucketsViewsLogsListCall) Do(opts ...googleapi.CallOption) (*ListLogsResponse, 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 := &ListLogsResponse{ + 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 the logs in projects, organizations, folders, or billing accounts. Only logs that have entries are listed.", + // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/buckets/{bucketsId}/views/{viewsId}/logs", + // "httpMethod": "GET", + // "id": "logging.projects.locations.buckets.views.logs.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "pageSize": { + // "description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "Required. The resource name that owns the logs: projects/[PROJECT_ID] organizations/[ORGANIZATION_ID] billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID]", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+/buckets/[^/]+/views/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "resourceNames": { + // "description": "Optional. The resource name that owns the logs: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID] folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]To support legacy queries, it could also be: projects/[PROJECT_ID] organizations/[ORGANIZATION_ID] billingAccounts/[BILLING_ACCOUNT_ID] folders/[FOLDER_ID]", + // "location": "query", + // "repeated": true, + // "type": "string" + // } + // }, + // "path": "v2/{+parent}/logs", + // "response": { + // "$ref": "ListLogsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform", + // "https://www.googleapis.com/auth/cloud-platform.read-only", + // "https://www.googleapis.com/auth/logging.admin", + // "https://www.googleapis.com/auth/logging.read" + // ] + // } + +} + +// 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 *ProjectsLocationsBucketsViewsLogsListCall) Pages(ctx context.Context, f func(*ListLogsResponse) 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 "logging.projects.locations.operations.cancel": type ProjectsLocationsOperationsCancelCall struct { diff --git a/retail/v2/retail-api.json b/retail/v2/retail-api.json index a934e4ba79d..cad82ac8528 100644 --- a/retail/v2/retail-api.json +++ b/retail/v2/retail-api.json @@ -562,7 +562,7 @@ "type": "string" }, "updateMask": { - "description": "Indicates which fields in the provided Product to update. The immutable and output only fields are NOT supported. If not set, all supported fields (the fields that are neither immutable nor output only) are updated. If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned.", + "description": "Indicates which fields in the provided Product to update. The immutable and output only fields are NOT supported. If not set, all supported fields (the fields that are neither immutable nor output only) are updated. If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned. The attribute key can be updated by setting the mask path as \"attributes.${key_name}\". If a key name is present in the mask but not in the patching product from the request, this key will be deleted after the update.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -781,7 +781,7 @@ ], "parameters": { "placement": { - "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/placements/*} or {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} The ID of the Recommendations AI placement. Before you can request predictions from your model, you must create at least one placement for it. For more information, see [Managing placements](https://cloud.google.com/retail/recommendations-ai/docs/manage-placements). The full list of available placements can be seen at https://console.cloud.google.com/recommendation/catalogs/default_catalog/placements", + "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} or {name=projects/*/locations/global/catalogs/default_catalog/placements/*}. We recommend using the `servingConfigs` resource. `placements` is a legacy resource. The ID of the Recommendations AI serving config or placement. Before you can request predictions from your model, you must create at least one serving config or placement for it. For more information, see [Managing serving configurations]. (https://cloud.google.com/retail/docs/manage-configs). The full list of available serving configs can be seen at https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/placements/[^/]+$", "required": true, @@ -809,7 +809,7 @@ ], "parameters": { "placement": { - "description": "Required. The resource name of the search engine placement, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search` or `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` This field is used to identify the serving configuration name and the set of models that will be used to make the search.", + "description": "Required. The resource name of the Retail Search serving config, such as `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` or the name of the legacy placement resource, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search`. This field is used to identify the serving configuration name and the set of models that will be used to make the search.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/placements/[^/]+$", "required": true, @@ -841,7 +841,7 @@ ], "parameters": { "placement": { - "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/placements/*} or {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} The ID of the Recommendations AI placement. Before you can request predictions from your model, you must create at least one placement for it. For more information, see [Managing placements](https://cloud.google.com/retail/recommendations-ai/docs/manage-placements). The full list of available placements can be seen at https://console.cloud.google.com/recommendation/catalogs/default_catalog/placements", + "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} or {name=projects/*/locations/global/catalogs/default_catalog/placements/*}. We recommend using the `servingConfigs` resource. `placements` is a legacy resource. The ID of the Recommendations AI serving config or placement. Before you can request predictions from your model, you must create at least one serving config or placement for it. For more information, see [Managing serving configurations]. (https://cloud.google.com/retail/docs/manage-configs). The full list of available serving configs can be seen at https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/servingConfigs/[^/]+$", "required": true, @@ -869,7 +869,7 @@ ], "parameters": { "placement": { - "description": "Required. The resource name of the search engine placement, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search` or `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` This field is used to identify the serving configuration name and the set of models that will be used to make the search.", + "description": "Required. The resource name of the Retail Search serving config, such as `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` or the name of the legacy placement resource, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search`. This field is used to identify the serving configuration name and the set of models that will be used to make the search.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/servingConfigs/[^/]+$", "required": true, @@ -1193,7 +1193,7 @@ } } }, - "revision": "20220324", + "revision": "20220408", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -2006,7 +2006,7 @@ }, "userEvent": { "$ref": "GoogleCloudRetailV2UserEvent", - "description": "Required. Context about the user, what they are looking at and what action they took to trigger the predict request. Note that this user event detail won't be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging." + "description": "Required. Context about the user, what they are looking at and what action they took to trigger the predict request. Note that this user event detail won't be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging. Don't set UserEvent.visitor_id or UserInfo.user_id to the same fixed ID for different users. If you are trying to receive non-personalized recommendations (not recommended; this can negatively impact model performance), instead set UserEvent.visitor_id to a random unique ID and leave UserInfo.user_id unset." }, "validateOnly": { "description": "Use validate only mode for this prediction query. If set to true, a dummy model will be used that returns arbitrary products. Note that the validate only mode should only be used for testing the API, or if the model is not ready.", @@ -2383,11 +2383,11 @@ "id": "GoogleCloudRetailV2ProductLevelConfig", "properties": { "ingestionProductType": { - "description": "The type of Products allowed to be ingested into the catalog. Acceptable values are: * `primary` (default): You can ingest Products of all types. When ingesting a Product, its type will default to Product.Type.PRIMARY if unset. * `variant`: You can only ingest Product.Type.VARIANT Products. This means Product.primary_product_id cannot be empty. If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. If this field is `variant` and merchant_center_product_id_field is `itemGroupId`, an INVALID_ARGUMENT error is returned. See [Using product levels](https://cloud.google.com/retail/recommendations-ai/docs/catalog#product-levels) for more details.", + "description": "The type of Products allowed to be ingested into the catalog. Acceptable values are: * `primary` (default): You can ingest Products of all types. When ingesting a Product, its type will default to Product.Type.PRIMARY if unset. * `variant` (incompatible with Retail Search): You can only ingest Product.Type.VARIANT Products. This means Product.primary_product_id cannot be empty. If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. If this field is `variant` and merchant_center_product_id_field is `itemGroupId`, an INVALID_ARGUMENT error is returned. See [Product levels](https://cloud.google.com/retail/docs/catalog#product-levels) for more details.", "type": "string" }, "merchantCenterProductIdField": { - "description": "Which field of [Merchant Center Product](/bigquery-transfer/docs/merchant-center-products-schema) should be imported as Product.id. Acceptable values are: * `offerId` (default): Import `offerId` as the product ID. * `itemGroupId`: Import `itemGroupId` as the product ID. Notice that Retail API will choose one item from the ones with the same `itemGroupId`, and use it to represent the item group. If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. If this field is `itemGroupId` and ingestion_product_type is `variant`, an INVALID_ARGUMENT error is returned. See [Using product levels](https://cloud.google.com/retail/recommendations-ai/docs/catalog#product-levels) for more details.", + "description": "Which field of [Merchant Center Product](/bigquery-transfer/docs/merchant-center-products-schema) should be imported as Product.id. Acceptable values are: * `offerId` (default): Import `offerId` as the product ID. * `itemGroupId`: Import `itemGroupId` as the product ID. Notice that Retail API will choose one item from the ones with the same `itemGroupId`, and use it to represent the item group. If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. If this field is `itemGroupId` and ingestion_product_type is `variant`, an INVALID_ARGUMENT error is returned. See [Product levels](https://cloud.google.com/retail/docs/catalog#product-levels) for more details.", "type": "string" } }, @@ -2666,7 +2666,7 @@ "description": "The specification for personalization." }, "query": { - "description": "Raw search query.", + "description": "Raw search query. If this field is empty, the request is considered a category browsing request and returned results are based on filter and page_categories.", "type": "string" }, "queryExpansionSpec": { @@ -3184,7 +3184,7 @@ "description": "User information." }, "visitorId": { - "description": "Required. A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor log in/out of the website. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. The field should not contain PII or user-data. We recommend to use Google Analystics [Client ID](https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#clientId) for this field.", + "description": "Required. A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor log in/out of the website. Don't set the field to the same fixed ID for different users. This mixes the event history of those users together, which results in degraded model quality. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. The field should not contain PII or user-data. We recommend to use Google Analystics [Client ID](https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#clientId) for this field.", "type": "string" } }, @@ -3257,7 +3257,7 @@ "type": "string" }, "userId": { - "description": "Highly recommended for logged-in users. Unique identifier for logged-in user, such as a user name. Always use a hashed value for this ID. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", + "description": "Highly recommended for logged-in users. Unique identifier for logged-in user, such as a user name. Don't set for anonymous users. Always use a hashed value for this ID. Don't set the field to the same fixed ID for different users. This mixes the event history of those users together, which results in degraded model quality. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", "type": "string" } }, diff --git a/retail/v2/retail-gen.go b/retail/v2/retail-gen.go index b830d8fb4fb..e4f1eae89ba 100644 --- a/retail/v2/retail-gen.go +++ b/retail/v2/retail-gen.go @@ -1946,7 +1946,12 @@ type GoogleCloudRetailV2PredictRequest struct { // UserEvent: Required. Context about the user, what they are looking at // and what action they took to trigger the predict request. Note that // this user event detail won't be ingested to userEvent logs. Thus, a - // separate userEvent write request is required for event logging. + // separate userEvent write request is required for event logging. Don't + // set UserEvent.visitor_id or UserInfo.user_id to the same fixed ID for + // different users. If you are trying to receive non-personalized + // recommendations (not recommended; this can negatively impact model + // performance), instead set UserEvent.visitor_id to a random unique ID + // and leave UserInfo.user_id unset. UserEvent *GoogleCloudRetailV2UserEvent `json:"userEvent,omitempty"` // ValidateOnly: Use validate only mode for this prediction query. If @@ -2649,15 +2654,15 @@ type GoogleCloudRetailV2ProductLevelConfig struct { // IngestionProductType: The type of Products allowed to be ingested // into the catalog. Acceptable values are: * `primary` (default): You // can ingest Products of all types. When ingesting a Product, its type - // will default to Product.Type.PRIMARY if unset. * `variant`: You can - // only ingest Product.Type.VARIANT Products. This means - // Product.primary_product_id cannot be empty. If this field is set to - // an invalid value other than these, an INVALID_ARGUMENT error is - // returned. If this field is `variant` and - // merchant_center_product_id_field is `itemGroupId`, an - // INVALID_ARGUMENT error is returned. See Using product levels - // (https://cloud.google.com/retail/recommendations-ai/docs/catalog#product-levels) - // for more details. + // will default to Product.Type.PRIMARY if unset. * `variant` + // (incompatible with Retail Search): You can only ingest + // Product.Type.VARIANT Products. This means Product.primary_product_id + // cannot be empty. If this field is set to an invalid value other than + // these, an INVALID_ARGUMENT error is returned. If this field is + // `variant` and merchant_center_product_id_field is `itemGroupId`, an + // INVALID_ARGUMENT error is returned. See Product levels + // (https://cloud.google.com/retail/docs/catalog#product-levels) for + // more details. IngestionProductType string `json:"ingestionProductType,omitempty"` // MerchantCenterProductIdField: Which field of Merchant Center Product @@ -2669,9 +2674,9 @@ type GoogleCloudRetailV2ProductLevelConfig struct { // represent the item group. If this field is set to an invalid value // other than these, an INVALID_ARGUMENT error is returned. If this // field is `itemGroupId` and ingestion_product_type is `variant`, an - // INVALID_ARGUMENT error is returned. See Using product levels - // (https://cloud.google.com/retail/recommendations-ai/docs/catalog#product-levels) - // for more details. + // INVALID_ARGUMENT error is returned. See Product levels + // (https://cloud.google.com/retail/docs/catalog#product-levels) for + // more details. MerchantCenterProductIdField string `json:"merchantCenterProductIdField,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -3234,7 +3239,9 @@ type GoogleCloudRetailV2SearchRequest struct { // PersonalizationSpec: The specification for personalization. PersonalizationSpec *GoogleCloudRetailV2SearchRequestPersonalizationSpec `json:"personalizationSpec,omitempty"` - // Query: Raw search query. + // Query: Raw search query. If this field is empty, the request is + // considered a category browsing request and returned results are based + // on filter and page_categories. Query string `json:"query,omitempty"` // QueryExpansionSpec: The query expansion specification that specifies @@ -4262,10 +4269,12 @@ type GoogleCloudRetailV2UserEvent struct { // example, this could be implemented with an HTTP cookie, which should // be able to uniquely identify a visitor on a single device. This // unique identifier should not change if the visitor log in/out of the - // website. The field must be a UTF-8 encoded string with a length limit - // of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. - // The field should not contain PII or user-data. We recommend to use - // Google Analystics Client ID + // website. Don't set the field to the same fixed ID for different + // users. This mixes the event history of those users together, which + // results in degraded model quality. The field must be a UTF-8 encoded + // string with a length limit of 128 characters. Otherwise, an + // INVALID_ARGUMENT error is returned. The field should not contain PII + // or user-data. We recommend to use Google Analystics Client ID // (https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#clientId) // for this field. VisitorId string `json:"visitorId,omitempty"` @@ -4430,9 +4439,12 @@ type GoogleCloudRetailV2UserInfo struct { UserAgent string `json:"userAgent,omitempty"` // UserId: Highly recommended for logged-in users. Unique identifier for - // logged-in user, such as a user name. Always use a hashed value for - // this ID. The field must be a UTF-8 encoded string with a length limit - // of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. + // logged-in user, such as a user name. Don't set for anonymous users. + // Always use a hashed value for this ID. Don't set the field to the + // same fixed ID for different users. This mixes the event history of + // those users together, which results in degraded model quality. The + // field must be a UTF-8 encoded string with a length limit of 128 + // characters. Otherwise, an INVALID_ARGUMENT error is returned. UserId string `json:"userId,omitempty"` // ForceSendFields is a list of field names (e.g. "DirectUserRequest") @@ -8025,7 +8037,10 @@ func (c *ProjectsLocationsCatalogsBranchesProductsPatchCall) AllowMissing(allowM // only fields are NOT supported. If not set, all supported fields (the // fields that are neither immutable nor output only) are updated. If an // unsupported or unknown field is provided, an INVALID_ARGUMENT error -// is returned. +// is returned. The attribute key can be updated by setting the mask +// path as "attributes.${key_name}". If a key name is present in the +// mask but not in the patching product from the request, this key will +// be deleted after the update. func (c *ProjectsLocationsCatalogsBranchesProductsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCatalogsBranchesProductsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -8143,7 +8158,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsPatchCall) Do(opts ...googleap // "type": "string" // }, // "updateMask": { - // "description": "Indicates which fields in the provided Product to update. The immutable and output only fields are NOT supported. If not set, all supported fields (the fields that are neither immutable nor output only) are updated. If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned.", + // "description": "Indicates which fields in the provided Product to update. The immutable and output only fields are NOT supported. If not set, all supported fields (the fields that are neither immutable nor output only) are updated. If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned. The attribute key can be updated by setting the mask path as \"attributes.${key_name}\". If a key name is present in the mask but not in the patching product from the request, this key will be deleted after the update.", // "format": "google-fieldmask", // "location": "query", // "type": "string" @@ -9160,15 +9175,18 @@ type ProjectsLocationsCatalogsPlacementsPredictCall struct { // Predict: Makes a recommendation prediction. // // - placement: Full resource name of the format: -// {name=projects/*/locations/global/catalogs/default_catalog/placement -// s/*} or // {name=projects/*/locations/global/catalogs/default_catalog/servingCo -// nfigs/*} The ID of the Recommendations AI placement. Before you can -// request predictions from your model, you must create at least one -// placement for it. For more information, see Managing placements -// (https://cloud.google.com/retail/recommendations-ai/docs/manage-placements). -// The full list of available placements can be seen at -// https://console.cloud.google.com/recommendation/catalogs/default_catalog/placements. +// nfigs/*} or +// {name=projects/*/locations/global/catalogs/default_catalog/placement +// s/*}. We recommend using the `servingConfigs` resource. +// `placements` is a legacy resource. The ID of the Recommendations AI +// serving config or placement. Before you can request predictions +// from your model, you must create at least one serving config or +// placement for it. For more information, see [Managing serving +// configurations]. +// (https://cloud.google.com/retail/docs/manage-configs). The full +// list of available serving configs can be seen at +// https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs. func (r *ProjectsLocationsCatalogsPlacementsService) Predict(placement string, googlecloudretailv2predictrequest *GoogleCloudRetailV2PredictRequest) *ProjectsLocationsCatalogsPlacementsPredictCall { c := &ProjectsLocationsCatalogsPlacementsPredictCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.placement = placement @@ -9277,7 +9295,7 @@ func (c *ProjectsLocationsCatalogsPlacementsPredictCall) Do(opts ...googleapi.Ca // ], // "parameters": { // "placement": { - // "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/placements/*} or {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} The ID of the Recommendations AI placement. Before you can request predictions from your model, you must create at least one placement for it. For more information, see [Managing placements](https://cloud.google.com/retail/recommendations-ai/docs/manage-placements). The full list of available placements can be seen at https://console.cloud.google.com/recommendation/catalogs/default_catalog/placements", + // "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} or {name=projects/*/locations/global/catalogs/default_catalog/placements/*}. We recommend using the `servingConfigs` resource. `placements` is a legacy resource. The ID of the Recommendations AI serving config or placement. Before you can request predictions from your model, you must create at least one serving config or placement for it. For more information, see [Managing serving configurations]. (https://cloud.google.com/retail/docs/manage-configs). The full list of available serving configs can be seen at https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/placements/[^/]+$", // "required": true, @@ -9313,12 +9331,13 @@ type ProjectsLocationsCatalogsPlacementsSearchCall struct { // who have Retail Search enabled. Please enable Retail Search on Cloud // Console before using this feature. // -// - placement: The resource name of the search engine placement, such -// as -// `projects/*/locations/global/catalogs/default_catalog/placements/def -// ault_search` or +// - placement: The resource name of the Retail Search serving config, +// such as // `projects/*/locations/global/catalogs/default_catalog/servingConfigs -// /default_serving_config` This field is used to identify the serving +// /default_serving_config` or the name of the legacy placement +// resource, such as +// `projects/*/locations/global/catalogs/default_catalog/placements/def +// ault_search`. This field is used to identify the serving // configuration name and the set of models that will be used to make // the search. func (r *ProjectsLocationsCatalogsPlacementsService) Search(placement string, googlecloudretailv2searchrequest *GoogleCloudRetailV2SearchRequest) *ProjectsLocationsCatalogsPlacementsSearchCall { @@ -9429,7 +9448,7 @@ func (c *ProjectsLocationsCatalogsPlacementsSearchCall) Do(opts ...googleapi.Cal // ], // "parameters": { // "placement": { - // "description": "Required. The resource name of the search engine placement, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search` or `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` This field is used to identify the serving configuration name and the set of models that will be used to make the search.", + // "description": "Required. The resource name of the Retail Search serving config, such as `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` or the name of the legacy placement resource, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search`. This field is used to identify the serving configuration name and the set of models that will be used to make the search.", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/placements/[^/]+$", // "required": true, @@ -9485,15 +9504,18 @@ type ProjectsLocationsCatalogsServingConfigsPredictCall struct { // Predict: Makes a recommendation prediction. // // - placement: Full resource name of the format: -// {name=projects/*/locations/global/catalogs/default_catalog/placement -// s/*} or // {name=projects/*/locations/global/catalogs/default_catalog/servingCo -// nfigs/*} The ID of the Recommendations AI placement. Before you can -// request predictions from your model, you must create at least one -// placement for it. For more information, see Managing placements -// (https://cloud.google.com/retail/recommendations-ai/docs/manage-placements). -// The full list of available placements can be seen at -// https://console.cloud.google.com/recommendation/catalogs/default_catalog/placements. +// nfigs/*} or +// {name=projects/*/locations/global/catalogs/default_catalog/placement +// s/*}. We recommend using the `servingConfigs` resource. +// `placements` is a legacy resource. The ID of the Recommendations AI +// serving config or placement. Before you can request predictions +// from your model, you must create at least one serving config or +// placement for it. For more information, see [Managing serving +// configurations]. +// (https://cloud.google.com/retail/docs/manage-configs). The full +// list of available serving configs can be seen at +// https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs. func (r *ProjectsLocationsCatalogsServingConfigsService) Predict(placement string, googlecloudretailv2predictrequest *GoogleCloudRetailV2PredictRequest) *ProjectsLocationsCatalogsServingConfigsPredictCall { c := &ProjectsLocationsCatalogsServingConfigsPredictCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.placement = placement @@ -9602,7 +9624,7 @@ func (c *ProjectsLocationsCatalogsServingConfigsPredictCall) Do(opts ...googleap // ], // "parameters": { // "placement": { - // "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/placements/*} or {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} The ID of the Recommendations AI placement. Before you can request predictions from your model, you must create at least one placement for it. For more information, see [Managing placements](https://cloud.google.com/retail/recommendations-ai/docs/manage-placements). The full list of available placements can be seen at https://console.cloud.google.com/recommendation/catalogs/default_catalog/placements", + // "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} or {name=projects/*/locations/global/catalogs/default_catalog/placements/*}. We recommend using the `servingConfigs` resource. `placements` is a legacy resource. The ID of the Recommendations AI serving config or placement. Before you can request predictions from your model, you must create at least one serving config or placement for it. For more information, see [Managing serving configurations]. (https://cloud.google.com/retail/docs/manage-configs). The full list of available serving configs can be seen at https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/servingConfigs/[^/]+$", // "required": true, @@ -9638,12 +9660,13 @@ type ProjectsLocationsCatalogsServingConfigsSearchCall struct { // who have Retail Search enabled. Please enable Retail Search on Cloud // Console before using this feature. // -// - placement: The resource name of the search engine placement, such -// as -// `projects/*/locations/global/catalogs/default_catalog/placements/def -// ault_search` or +// - placement: The resource name of the Retail Search serving config, +// such as // `projects/*/locations/global/catalogs/default_catalog/servingConfigs -// /default_serving_config` This field is used to identify the serving +// /default_serving_config` or the name of the legacy placement +// resource, such as +// `projects/*/locations/global/catalogs/default_catalog/placements/def +// ault_search`. This field is used to identify the serving // configuration name and the set of models that will be used to make // the search. func (r *ProjectsLocationsCatalogsServingConfigsService) Search(placement string, googlecloudretailv2searchrequest *GoogleCloudRetailV2SearchRequest) *ProjectsLocationsCatalogsServingConfigsSearchCall { @@ -9754,7 +9777,7 @@ func (c *ProjectsLocationsCatalogsServingConfigsSearchCall) Do(opts ...googleapi // ], // "parameters": { // "placement": { - // "description": "Required. The resource name of the search engine placement, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search` or `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` This field is used to identify the serving configuration name and the set of models that will be used to make the search.", + // "description": "Required. The resource name of the Retail Search serving config, such as `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` or the name of the legacy placement resource, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search`. This field is used to identify the serving configuration name and the set of models that will be used to make the search.", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/servingConfigs/[^/]+$", // "required": true, diff --git a/retail/v2alpha/retail-api.json b/retail/v2alpha/retail-api.json index 6cf16ef96f3..790e1db12cf 100644 --- a/retail/v2alpha/retail-api.json +++ b/retail/v2alpha/retail-api.json @@ -773,7 +773,7 @@ "type": "string" }, "updateMask": { - "description": "Indicates which fields in the provided Product to update. The immutable and output only fields are NOT supported. If not set, all supported fields (the fields that are neither immutable nor output only) are updated. If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned.", + "description": "Indicates which fields in the provided Product to update. The immutable and output only fields are NOT supported. If not set, all supported fields (the fields that are neither immutable nor output only) are updated. If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned. The attribute key can be updated by setting the mask path as \"attributes.${key_name}\". If a key name is present in the mask but not in the patching product from the request, this key will be deleted after the update.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -1182,7 +1182,7 @@ ], "parameters": { "placement": { - "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/placements/*} or {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} The ID of the Recommendations AI placement. Before you can request predictions from your model, you must create at least one placement for it. For more information, see [Managing placements](https://cloud.google.com/retail/recommendations-ai/docs/manage-placements). The full list of available placements can be seen at https://console.cloud.google.com/recommendation/catalogs/default_catalog/placements", + "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} or {name=projects/*/locations/global/catalogs/default_catalog/placements/*}. We recommend using the `servingConfigs` resource. `placements` is a legacy resource. The ID of the Recommendations AI serving config or placement. Before you can request predictions from your model, you must create at least one serving config or placement for it. For more information, see [Managing serving configurations]. (https://cloud.google.com/retail/docs/manage-configs). The full list of available serving configs can be seen at https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/placements/[^/]+$", "required": true, @@ -1210,7 +1210,7 @@ ], "parameters": { "placement": { - "description": "Required. The resource name of the search engine placement, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search` or `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` This field is used to identify the serving configuration name and the set of models that will be used to make the search.", + "description": "Required. The resource name of the Retail Search serving config, such as `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` or the name of the legacy placement resource, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search`. This field is used to identify the serving configuration name and the set of models that will be used to make the search.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/placements/[^/]+$", "required": true, @@ -1423,7 +1423,7 @@ ], "parameters": { "placement": { - "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/placements/*} or {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} The ID of the Recommendations AI placement. Before you can request predictions from your model, you must create at least one placement for it. For more information, see [Managing placements](https://cloud.google.com/retail/recommendations-ai/docs/manage-placements). The full list of available placements can be seen at https://console.cloud.google.com/recommendation/catalogs/default_catalog/placements", + "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} or {name=projects/*/locations/global/catalogs/default_catalog/placements/*}. We recommend using the `servingConfigs` resource. `placements` is a legacy resource. The ID of the Recommendations AI serving config or placement. Before you can request predictions from your model, you must create at least one serving config or placement for it. For more information, see [Managing serving configurations]. (https://cloud.google.com/retail/docs/manage-configs). The full list of available serving configs can be seen at https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/servingConfigs/[^/]+$", "required": true, @@ -1479,7 +1479,7 @@ ], "parameters": { "placement": { - "description": "Required. The resource name of the search engine placement, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search` or `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` This field is used to identify the serving configuration name and the set of models that will be used to make the search.", + "description": "Required. The resource name of the Retail Search serving config, such as `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` or the name of the legacy placement resource, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search`. This field is used to identify the serving configuration name and the set of models that will be used to make the search.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/servingConfigs/[^/]+$", "required": true, @@ -1803,7 +1803,7 @@ } } }, - "revision": "20220324", + "revision": "20220408", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -2697,23 +2697,6 @@ "$ref": "GoogleCloudRetailV2alphaRule", "description": "A rule control - a condition-action pair. Enacts a set action when the condition is triggered. For example: Boost \"gShoe\" when query full matches \"Running Shoes\"." }, - "searchSolutionUseCase": { - "description": "Required. Specifies the use case for the control. Affects what condition fields can be set. Only settable by search controls. Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified. Currently only allow one search_solution_use_case per control.", - "items": { - "enum": [ - "SEARCH_SOLUTION_USE_CASE_UNSPECIFIED", - "SEARCH_SOLUTION_USE_CASE_SEARCH", - "SEARCH_SOLUTION_USE_CASE_BROWSE" - ], - "enumDescriptions": [ - "The value when it's unspecified. Defaults to SEARCH.", - "Search use case. Expects the traffic has a non-empty query.", - "Browse use case. Expects the traffic has an empty query." - ], - "type": "string" - }, - "type": "array" - }, "solutionTypes": { "description": "Required. Immutable. The solution types that the serving config is used for. Currently we support setting only one type of solution at creation time. Only `SOLUTION_TYPE_SEARCH` value is supported at the moment. If no solution type is provided at creation time, will default to SOLUTION_TYPE_SEARCH.", "items": { @@ -3288,7 +3271,7 @@ }, "userEvent": { "$ref": "GoogleCloudRetailV2alphaUserEvent", - "description": "Required. Context about the user, what they are looking at and what action they took to trigger the predict request. Note that this user event detail won't be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging." + "description": "Required. Context about the user, what they are looking at and what action they took to trigger the predict request. Note that this user event detail won't be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging. Don't set UserEvent.visitor_id or UserInfo.user_id to the same fixed ID for different users. If you are trying to receive non-personalized recommendations (not recommended; this can negatively impact model performance), instead set UserEvent.visitor_id to a random unique ID and leave UserInfo.user_id unset." }, "validateOnly": { "description": "Use validate only mode for this prediction query. If set to true, a dummy model will be used that returns arbitrary products. Note that the validate only mode should only be used for testing the API, or if the model is not ready.", @@ -3665,11 +3648,11 @@ "id": "GoogleCloudRetailV2alphaProductLevelConfig", "properties": { "ingestionProductType": { - "description": "The type of Products allowed to be ingested into the catalog. Acceptable values are: * `primary` (default): You can ingest Products of all types. When ingesting a Product, its type will default to Product.Type.PRIMARY if unset. * `variant`: You can only ingest Product.Type.VARIANT Products. This means Product.primary_product_id cannot be empty. If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. If this field is `variant` and merchant_center_product_id_field is `itemGroupId`, an INVALID_ARGUMENT error is returned. See [Using product levels](https://cloud.google.com/retail/recommendations-ai/docs/catalog#product-levels) for more details.", + "description": "The type of Products allowed to be ingested into the catalog. Acceptable values are: * `primary` (default): You can ingest Products of all types. When ingesting a Product, its type will default to Product.Type.PRIMARY if unset. * `variant` (incompatible with Retail Search): You can only ingest Product.Type.VARIANT Products. This means Product.primary_product_id cannot be empty. If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. If this field is `variant` and merchant_center_product_id_field is `itemGroupId`, an INVALID_ARGUMENT error is returned. See [Product levels](https://cloud.google.com/retail/docs/catalog#product-levels) for more details.", "type": "string" }, "merchantCenterProductIdField": { - "description": "Which field of [Merchant Center Product](/bigquery-transfer/docs/merchant-center-products-schema) should be imported as Product.id. Acceptable values are: * `offerId` (default): Import `offerId` as the product ID. * `itemGroupId`: Import `itemGroupId` as the product ID. Notice that Retail API will choose one item from the ones with the same `itemGroupId`, and use it to represent the item group. If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. If this field is `itemGroupId` and ingestion_product_type is `variant`, an INVALID_ARGUMENT error is returned. See [Using product levels](https://cloud.google.com/retail/recommendations-ai/docs/catalog#product-levels) for more details.", + "description": "Which field of [Merchant Center Product](/bigquery-transfer/docs/merchant-center-products-schema) should be imported as Product.id. Acceptable values are: * `offerId` (default): Import `offerId` as the product ID. * `itemGroupId`: Import `itemGroupId` as the product ID. Notice that Retail API will choose one item from the ones with the same `itemGroupId`, and use it to represent the item group. If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. If this field is `itemGroupId` and ingestion_product_type is `variant`, an INVALID_ARGUMENT error is returned. See [Product levels](https://cloud.google.com/retail/docs/catalog#product-levels) for more details.", "type": "string" } }, @@ -3754,7 +3737,7 @@ "id": "GoogleCloudRetailV2alphaPurgeProductsRequest", "properties": { "filter": { - "description": "Required. The filter string to specify the products to be deleted with a length limit of 5,000 characters. Empty string filter is not allowed. \"*\" implies delete all items in a branch. The eligible fields for filtering are: * `availability`: Double quoted Product.availability string. * `create_time` : in ISO 8601 \"zulu\" format. Supported syntax: * Comparators (\"\u003e\", \"\u003c\", \"\u003e=\", \"\u003c=\", \"=\"). Examples: * create_time \u003c= \"2015-02-13T17:05:46Z\" * availability = \"IN_STOCK” * Conjunctions (\"AND\") Examples: * create_time \u003c= \"2015-02-13T17:05:46Z\" AND availability = \"PREORDER\" * Disjunctions (\"OR\") Examples: * create_time \u003c= \"2015-02-13T17:05:46Z\" OR availability = \"IN_STOCK\" * Can support nested queries. Examples: * (create_time \u003c= \"2015-02-13T17:05:46Z\" AND availability = \"PREORDER\") OR (create_time \u003e= \"2015-02-14T13:03:32Z\" AND availability = \"IN_STOCK\") * Filter Limits: * Filter should not contain more than 6 conditions. * Max nesting depth should not exceed 2 levels. Examples queries: * Delete back order products created before a timestamp. create_time \u003c= \"2015-02-13T17:05:46Z\" OR availability = \"BACKORDER”", + "description": "Required. The filter string to specify the products to be deleted with a length limit of 5,000 characters. Empty string filter is not allowed. \"*\" implies delete all items in a branch. The eligible fields for filtering are: * `availability`: Double quoted Product.availability string. * `create_time` : in ISO 8601 \"zulu\" format. Supported syntax: * Comparators (\"\u003e\", \"\u003c\", \"\u003e=\", \"\u003c=\", \"=\"). Examples: * create_time \u003c= \"2015-02-13T17:05:46Z\" * availability = \"IN_STOCK\" * Conjunctions (\"AND\") Examples: * create_time \u003c= \"2015-02-13T17:05:46Z\" AND availability = \"PREORDER\" * Disjunctions (\"OR\") Examples: * create_time \u003c= \"2015-02-13T17:05:46Z\" OR availability = \"IN_STOCK\" * Can support nested queries. Examples: * (create_time \u003c= \"2015-02-13T17:05:46Z\" AND availability = \"PREORDER\") OR (create_time \u003e= \"2015-02-14T13:03:32Z\" AND availability = \"IN_STOCK\") * Filter Limits: * Filter should not contain more than 6 conditions. * Max nesting depth should not exceed 2 levels. Examples queries: * Delete back order products created before a timestamp. create_time \u003c= \"2015-02-13T17:05:46Z\" OR availability = \"BACKORDER\"", "type": "string" }, "force": { @@ -4234,7 +4217,7 @@ "description": "The specification for personalization." }, "query": { - "description": "Raw search query.", + "description": "Raw search query. If this field is empty, the request is considered a category browsing request and returned results are based on filter and page_categories.", "type": "string" }, "queryExpansionSpec": { @@ -4885,7 +4868,7 @@ "description": "User information." }, "visitorId": { - "description": "Required. A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor log in/out of the website. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. The field should not contain PII or user-data. We recommend to use Google Analystics [Client ID](https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#clientId) for this field.", + "description": "Required. A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor log in/out of the website. Don't set the field to the same fixed ID for different users. This mixes the event history of those users together, which results in degraded model quality. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. The field should not contain PII or user-data. We recommend to use Google Analystics [Client ID](https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#clientId) for this field.", "type": "string" } }, @@ -4958,7 +4941,7 @@ "type": "string" }, "userId": { - "description": "Highly recommended for logged-in users. Unique identifier for logged-in user, such as a user name. Always use a hashed value for this ID. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", + "description": "Highly recommended for logged-in users. Unique identifier for logged-in user, such as a user name. Don't set for anonymous users. Always use a hashed value for this ID. Don't set the field to the same fixed ID for different users. This mixes the event history of those users together, which results in degraded model quality. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", "type": "string" } }, diff --git a/retail/v2alpha/retail-gen.go b/retail/v2alpha/retail-gen.go index 9ea86c98922..2f25c777ab4 100644 --- a/retail/v2alpha/retail-gen.go +++ b/retail/v2alpha/retail-gen.go @@ -1967,21 +1967,6 @@ type GoogleCloudRetailV2alphaControl struct { // query full matches "Running Shoes". Rule *GoogleCloudRetailV2alphaRule `json:"rule,omitempty"` - // SearchSolutionUseCase: Required. Specifies the use case for the - // control. Affects what condition fields can be set. Only settable by - // search controls. Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if - // not specified. Currently only allow one search_solution_use_case per - // control. - // - // Possible values: - // "SEARCH_SOLUTION_USE_CASE_UNSPECIFIED" - The value when it's - // unspecified. Defaults to SEARCH. - // "SEARCH_SOLUTION_USE_CASE_SEARCH" - Search use case. Expects the - // traffic has a non-empty query. - // "SEARCH_SOLUTION_USE_CASE_BROWSE" - Browse use case. Expects the - // traffic has an empty query. - SearchSolutionUseCase []string `json:"searchSolutionUseCase,omitempty"` - // SolutionTypes: Required. Immutable. The solution types that the // serving config is used for. Currently we support setting only one // type of solution at creation time. Only `SOLUTION_TYPE_SEARCH` value @@ -3167,7 +3152,12 @@ type GoogleCloudRetailV2alphaPredictRequest struct { // UserEvent: Required. Context about the user, what they are looking at // and what action they took to trigger the predict request. Note that // this user event detail won't be ingested to userEvent logs. Thus, a - // separate userEvent write request is required for event logging. + // separate userEvent write request is required for event logging. Don't + // set UserEvent.visitor_id or UserInfo.user_id to the same fixed ID for + // different users. If you are trying to receive non-personalized + // recommendations (not recommended; this can negatively impact model + // performance), instead set UserEvent.visitor_id to a random unique ID + // and leave UserInfo.user_id unset. UserEvent *GoogleCloudRetailV2alphaUserEvent `json:"userEvent,omitempty"` // ValidateOnly: Use validate only mode for this prediction query. If @@ -3871,15 +3861,15 @@ type GoogleCloudRetailV2alphaProductLevelConfig struct { // IngestionProductType: The type of Products allowed to be ingested // into the catalog. Acceptable values are: * `primary` (default): You // can ingest Products of all types. When ingesting a Product, its type - // will default to Product.Type.PRIMARY if unset. * `variant`: You can - // only ingest Product.Type.VARIANT Products. This means - // Product.primary_product_id cannot be empty. If this field is set to - // an invalid value other than these, an INVALID_ARGUMENT error is - // returned. If this field is `variant` and - // merchant_center_product_id_field is `itemGroupId`, an - // INVALID_ARGUMENT error is returned. See Using product levels - // (https://cloud.google.com/retail/recommendations-ai/docs/catalog#product-levels) - // for more details. + // will default to Product.Type.PRIMARY if unset. * `variant` + // (incompatible with Retail Search): You can only ingest + // Product.Type.VARIANT Products. This means Product.primary_product_id + // cannot be empty. If this field is set to an invalid value other than + // these, an INVALID_ARGUMENT error is returned. If this field is + // `variant` and merchant_center_product_id_field is `itemGroupId`, an + // INVALID_ARGUMENT error is returned. See Product levels + // (https://cloud.google.com/retail/docs/catalog#product-levels) for + // more details. IngestionProductType string `json:"ingestionProductType,omitempty"` // MerchantCenterProductIdField: Which field of Merchant Center Product @@ -3891,9 +3881,9 @@ type GoogleCloudRetailV2alphaProductLevelConfig struct { // represent the item group. If this field is set to an invalid value // other than these, an INVALID_ARGUMENT error is returned. If this // field is `itemGroupId` and ingestion_product_type is `variant`, an - // INVALID_ARGUMENT error is returned. See Using product levels - // (https://cloud.google.com/retail/recommendations-ai/docs/catalog#product-levels) - // for more details. + // INVALID_ARGUMENT error is returned. See Product levels + // (https://cloud.google.com/retail/docs/catalog#product-levels) for + // more details. MerchantCenterProductIdField string `json:"merchantCenterProductIdField,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -4076,7 +4066,7 @@ type GoogleCloudRetailV2alphaPurgeProductsRequest struct { // Product.availability string. * `create_time` : in ISO 8601 "zulu" // format. Supported syntax: * Comparators (">", "<", ">=", "<=", "="). // Examples: * create_time <= "2015-02-13T17:05:46Z" * availability = - // "IN_STOCK” * Conjunctions ("AND") Examples: * create_time <= + // "IN_STOCK" * Conjunctions ("AND") Examples: * create_time <= // "2015-02-13T17:05:46Z" AND availability = "PREORDER" * Disjunctions // ("OR") Examples: * create_time <= "2015-02-13T17:05:46Z" OR // availability = "IN_STOCK" * Can support nested queries. Examples: * @@ -4085,7 +4075,7 @@ type GoogleCloudRetailV2alphaPurgeProductsRequest struct { // "IN_STOCK") * Filter Limits: * Filter should not contain more than 6 // conditions. * Max nesting depth should not exceed 2 levels. Examples // queries: * Delete back order products created before a timestamp. - // create_time <= "2015-02-13T17:05:46Z" OR availability = "BACKORDER” + // create_time <= "2015-02-13T17:05:46Z" OR availability = "BACKORDER" Filter string `json:"filter,omitempty"` // Force: Actually perform the purge. If `force` is set to false, the @@ -5055,7 +5045,9 @@ type GoogleCloudRetailV2alphaSearchRequest struct { // PersonalizationSpec: The specification for personalization. PersonalizationSpec *GoogleCloudRetailV2alphaSearchRequestPersonalizationSpec `json:"personalizationSpec,omitempty"` - // Query: Raw search query. + // Query: Raw search query. If this field is empty, the request is + // considered a category browsing request and returned results are based + // on filter and page_categories. Query string `json:"query,omitempty"` // QueryExpansionSpec: The query expansion specification that specifies @@ -6265,10 +6257,12 @@ type GoogleCloudRetailV2alphaUserEvent struct { // example, this could be implemented with an HTTP cookie, which should // be able to uniquely identify a visitor on a single device. This // unique identifier should not change if the visitor log in/out of the - // website. The field must be a UTF-8 encoded string with a length limit - // of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. - // The field should not contain PII or user-data. We recommend to use - // Google Analystics Client ID + // website. Don't set the field to the same fixed ID for different + // users. This mixes the event history of those users together, which + // results in degraded model quality. The field must be a UTF-8 encoded + // string with a length limit of 128 characters. Otherwise, an + // INVALID_ARGUMENT error is returned. The field should not contain PII + // or user-data. We recommend to use Google Analystics Client ID // (https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#clientId) // for this field. VisitorId string `json:"visitorId,omitempty"` @@ -6433,9 +6427,12 @@ type GoogleCloudRetailV2alphaUserInfo struct { UserAgent string `json:"userAgent,omitempty"` // UserId: Highly recommended for logged-in users. Unique identifier for - // logged-in user, such as a user name. Always use a hashed value for - // this ID. The field must be a UTF-8 encoded string with a length limit - // of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. + // logged-in user, such as a user name. Don't set for anonymous users. + // Always use a hashed value for this ID. Don't set the field to the + // same fixed ID for different users. This mixes the event history of + // those users together, which results in degraded model quality. The + // field must be a UTF-8 encoded string with a length limit of 128 + // characters. Otherwise, an INVALID_ARGUMENT error is returned. UserId string `json:"userId,omitempty"` // ForceSendFields is a list of field names (e.g. "DirectUserRequest") @@ -10531,7 +10528,10 @@ func (c *ProjectsLocationsCatalogsBranchesProductsPatchCall) AllowMissing(allowM // only fields are NOT supported. If not set, all supported fields (the // fields that are neither immutable nor output only) are updated. If an // unsupported or unknown field is provided, an INVALID_ARGUMENT error -// is returned. +// is returned. The attribute key can be updated by setting the mask +// path as "attributes.${key_name}". If a key name is present in the +// mask but not in the patching product from the request, this key will +// be deleted after the update. func (c *ProjectsLocationsCatalogsBranchesProductsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCatalogsBranchesProductsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -10649,7 +10649,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsPatchCall) Do(opts ...googleap // "type": "string" // }, // "updateMask": { - // "description": "Indicates which fields in the provided Product to update. The immutable and output only fields are NOT supported. If not set, all supported fields (the fields that are neither immutable nor output only) are updated. If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned.", + // "description": "Indicates which fields in the provided Product to update. The immutable and output only fields are NOT supported. If not set, all supported fields (the fields that are neither immutable nor output only) are updated. If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned. The attribute key can be updated by setting the mask path as \"attributes.${key_name}\". If a key name is present in the mask but not in the patching product from the request, this key will be deleted after the update.", // "format": "google-fieldmask", // "location": "query", // "type": "string" @@ -12632,15 +12632,18 @@ type ProjectsLocationsCatalogsPlacementsPredictCall struct { // Predict: Makes a recommendation prediction. // // - placement: Full resource name of the format: -// {name=projects/*/locations/global/catalogs/default_catalog/placement -// s/*} or // {name=projects/*/locations/global/catalogs/default_catalog/servingCo -// nfigs/*} The ID of the Recommendations AI placement. Before you can -// request predictions from your model, you must create at least one -// placement for it. For more information, see Managing placements -// (https://cloud.google.com/retail/recommendations-ai/docs/manage-placements). -// The full list of available placements can be seen at -// https://console.cloud.google.com/recommendation/catalogs/default_catalog/placements. +// nfigs/*} or +// {name=projects/*/locations/global/catalogs/default_catalog/placement +// s/*}. We recommend using the `servingConfigs` resource. +// `placements` is a legacy resource. The ID of the Recommendations AI +// serving config or placement. Before you can request predictions +// from your model, you must create at least one serving config or +// placement for it. For more information, see [Managing serving +// configurations]. +// (https://cloud.google.com/retail/docs/manage-configs). The full +// list of available serving configs can be seen at +// https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs. func (r *ProjectsLocationsCatalogsPlacementsService) Predict(placement string, googlecloudretailv2alphapredictrequest *GoogleCloudRetailV2alphaPredictRequest) *ProjectsLocationsCatalogsPlacementsPredictCall { c := &ProjectsLocationsCatalogsPlacementsPredictCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.placement = placement @@ -12749,7 +12752,7 @@ func (c *ProjectsLocationsCatalogsPlacementsPredictCall) Do(opts ...googleapi.Ca // ], // "parameters": { // "placement": { - // "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/placements/*} or {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} The ID of the Recommendations AI placement. Before you can request predictions from your model, you must create at least one placement for it. For more information, see [Managing placements](https://cloud.google.com/retail/recommendations-ai/docs/manage-placements). The full list of available placements can be seen at https://console.cloud.google.com/recommendation/catalogs/default_catalog/placements", + // "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} or {name=projects/*/locations/global/catalogs/default_catalog/placements/*}. We recommend using the `servingConfigs` resource. `placements` is a legacy resource. The ID of the Recommendations AI serving config or placement. Before you can request predictions from your model, you must create at least one serving config or placement for it. For more information, see [Managing serving configurations]. (https://cloud.google.com/retail/docs/manage-configs). The full list of available serving configs can be seen at https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/placements/[^/]+$", // "required": true, @@ -12785,12 +12788,13 @@ type ProjectsLocationsCatalogsPlacementsSearchCall struct { // who have Retail Search enabled. Please enable Retail Search on Cloud // Console before using this feature. // -// - placement: The resource name of the search engine placement, such -// as -// `projects/*/locations/global/catalogs/default_catalog/placements/def -// ault_search` or +// - placement: The resource name of the Retail Search serving config, +// such as // `projects/*/locations/global/catalogs/default_catalog/servingConfigs -// /default_serving_config` This field is used to identify the serving +// /default_serving_config` or the name of the legacy placement +// resource, such as +// `projects/*/locations/global/catalogs/default_catalog/placements/def +// ault_search`. This field is used to identify the serving // configuration name and the set of models that will be used to make // the search. func (r *ProjectsLocationsCatalogsPlacementsService) Search(placement string, googlecloudretailv2alphasearchrequest *GoogleCloudRetailV2alphaSearchRequest) *ProjectsLocationsCatalogsPlacementsSearchCall { @@ -12901,7 +12905,7 @@ func (c *ProjectsLocationsCatalogsPlacementsSearchCall) Do(opts ...googleapi.Cal // ], // "parameters": { // "placement": { - // "description": "Required. The resource name of the search engine placement, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search` or `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` This field is used to identify the serving configuration name and the set of models that will be used to make the search.", + // "description": "Required. The resource name of the Retail Search serving config, such as `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` or the name of the legacy placement resource, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search`. This field is used to identify the serving configuration name and the set of models that will be used to make the search.", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/placements/[^/]+$", // "required": true, @@ -13911,15 +13915,18 @@ type ProjectsLocationsCatalogsServingConfigsPredictCall struct { // Predict: Makes a recommendation prediction. // // - placement: Full resource name of the format: -// {name=projects/*/locations/global/catalogs/default_catalog/placement -// s/*} or // {name=projects/*/locations/global/catalogs/default_catalog/servingCo -// nfigs/*} The ID of the Recommendations AI placement. Before you can -// request predictions from your model, you must create at least one -// placement for it. For more information, see Managing placements -// (https://cloud.google.com/retail/recommendations-ai/docs/manage-placements). -// The full list of available placements can be seen at -// https://console.cloud.google.com/recommendation/catalogs/default_catalog/placements. +// nfigs/*} or +// {name=projects/*/locations/global/catalogs/default_catalog/placement +// s/*}. We recommend using the `servingConfigs` resource. +// `placements` is a legacy resource. The ID of the Recommendations AI +// serving config or placement. Before you can request predictions +// from your model, you must create at least one serving config or +// placement for it. For more information, see [Managing serving +// configurations]. +// (https://cloud.google.com/retail/docs/manage-configs). The full +// list of available serving configs can be seen at +// https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs. func (r *ProjectsLocationsCatalogsServingConfigsService) Predict(placement string, googlecloudretailv2alphapredictrequest *GoogleCloudRetailV2alphaPredictRequest) *ProjectsLocationsCatalogsServingConfigsPredictCall { c := &ProjectsLocationsCatalogsServingConfigsPredictCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.placement = placement @@ -14028,7 +14035,7 @@ func (c *ProjectsLocationsCatalogsServingConfigsPredictCall) Do(opts ...googleap // ], // "parameters": { // "placement": { - // "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/placements/*} or {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} The ID of the Recommendations AI placement. Before you can request predictions from your model, you must create at least one placement for it. For more information, see [Managing placements](https://cloud.google.com/retail/recommendations-ai/docs/manage-placements). The full list of available placements can be seen at https://console.cloud.google.com/recommendation/catalogs/default_catalog/placements", + // "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} or {name=projects/*/locations/global/catalogs/default_catalog/placements/*}. We recommend using the `servingConfigs` resource. `placements` is a legacy resource. The ID of the Recommendations AI serving config or placement. Before you can request predictions from your model, you must create at least one serving config or placement for it. For more information, see [Managing serving configurations]. (https://cloud.google.com/retail/docs/manage-configs). The full list of available serving configs can be seen at https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/servingConfigs/[^/]+$", // "required": true, @@ -14211,12 +14218,13 @@ type ProjectsLocationsCatalogsServingConfigsSearchCall struct { // who have Retail Search enabled. Please enable Retail Search on Cloud // Console before using this feature. // -// - placement: The resource name of the search engine placement, such -// as -// `projects/*/locations/global/catalogs/default_catalog/placements/def -// ault_search` or +// - placement: The resource name of the Retail Search serving config, +// such as // `projects/*/locations/global/catalogs/default_catalog/servingConfigs -// /default_serving_config` This field is used to identify the serving +// /default_serving_config` or the name of the legacy placement +// resource, such as +// `projects/*/locations/global/catalogs/default_catalog/placements/def +// ault_search`. This field is used to identify the serving // configuration name and the set of models that will be used to make // the search. func (r *ProjectsLocationsCatalogsServingConfigsService) Search(placement string, googlecloudretailv2alphasearchrequest *GoogleCloudRetailV2alphaSearchRequest) *ProjectsLocationsCatalogsServingConfigsSearchCall { @@ -14327,7 +14335,7 @@ func (c *ProjectsLocationsCatalogsServingConfigsSearchCall) Do(opts ...googleapi // ], // "parameters": { // "placement": { - // "description": "Required. The resource name of the search engine placement, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search` or `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` This field is used to identify the serving configuration name and the set of models that will be used to make the search.", + // "description": "Required. The resource name of the Retail Search serving config, such as `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` or the name of the legacy placement resource, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search`. This field is used to identify the serving configuration name and the set of models that will be used to make the search.", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/servingConfigs/[^/]+$", // "required": true, diff --git a/retail/v2beta/retail-api.json b/retail/v2beta/retail-api.json index 0e0f4e50ae4..9a472412cd3 100644 --- a/retail/v2beta/retail-api.json +++ b/retail/v2beta/retail-api.json @@ -768,7 +768,7 @@ "type": "string" }, "updateMask": { - "description": "Indicates which fields in the provided Product to update. The immutable and output only fields are NOT supported. If not set, all supported fields (the fields that are neither immutable nor output only) are updated. If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned.", + "description": "Indicates which fields in the provided Product to update. The immutable and output only fields are NOT supported. If not set, all supported fields (the fields that are neither immutable nor output only) are updated. If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned. The attribute key can be updated by setting the mask path as \"attributes.${key_name}\". If a key name is present in the mask but not in the patching product from the request, this key will be deleted after the update.", "format": "google-fieldmask", "location": "query", "type": "string" @@ -1149,7 +1149,7 @@ ], "parameters": { "placement": { - "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/placements/*} or {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} The ID of the Recommendations AI placement. Before you can request predictions from your model, you must create at least one placement for it. For more information, see [Managing placements](https://cloud.google.com/retail/recommendations-ai/docs/manage-placements). The full list of available placements can be seen at https://console.cloud.google.com/recommendation/catalogs/default_catalog/placements", + "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} or {name=projects/*/locations/global/catalogs/default_catalog/placements/*}. We recommend using the `servingConfigs` resource. `placements` is a legacy resource. The ID of the Recommendations AI serving config or placement. Before you can request predictions from your model, you must create at least one serving config or placement for it. For more information, see [Managing serving configurations]. (https://cloud.google.com/retail/docs/manage-configs). The full list of available serving configs can be seen at https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/placements/[^/]+$", "required": true, @@ -1177,7 +1177,7 @@ ], "parameters": { "placement": { - "description": "Required. The resource name of the search engine placement, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search` or `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` This field is used to identify the serving configuration name and the set of models that will be used to make the search.", + "description": "Required. The resource name of the Retail Search serving config, such as `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` or the name of the legacy placement resource, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search`. This field is used to identify the serving configuration name and the set of models that will be used to make the search.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/placements/[^/]+$", "required": true, @@ -1390,7 +1390,7 @@ ], "parameters": { "placement": { - "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/placements/*} or {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} The ID of the Recommendations AI placement. Before you can request predictions from your model, you must create at least one placement for it. For more information, see [Managing placements](https://cloud.google.com/retail/recommendations-ai/docs/manage-placements). The full list of available placements can be seen at https://console.cloud.google.com/recommendation/catalogs/default_catalog/placements", + "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} or {name=projects/*/locations/global/catalogs/default_catalog/placements/*}. We recommend using the `servingConfigs` resource. `placements` is a legacy resource. The ID of the Recommendations AI serving config or placement. Before you can request predictions from your model, you must create at least one serving config or placement for it. For more information, see [Managing serving configurations]. (https://cloud.google.com/retail/docs/manage-configs). The full list of available serving configs can be seen at https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/servingConfigs/[^/]+$", "required": true, @@ -1446,7 +1446,7 @@ ], "parameters": { "placement": { - "description": "Required. The resource name of the search engine placement, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search` or `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` This field is used to identify the serving configuration name and the set of models that will be used to make the search.", + "description": "Required. The resource name of the Retail Search serving config, such as `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` or the name of the legacy placement resource, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search`. This field is used to identify the serving configuration name and the set of models that will be used to make the search.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/servingConfigs/[^/]+$", "required": true, @@ -1770,7 +1770,7 @@ } } }, - "revision": "20220324", + "revision": "20220408", "rootUrl": "https://retail.googleapis.com/", "schemas": { "GoogleApiHttpBody": { @@ -2987,23 +2987,6 @@ "$ref": "GoogleCloudRetailV2betaRule", "description": "A rule control - a condition-action pair. Enacts a set action when the condition is triggered. For example: Boost \"gShoe\" when query full matches \"Running Shoes\"." }, - "searchSolutionUseCase": { - "description": "Required. Specifies the use case for the control. Affects what condition fields can be set. Only settable by search controls. Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified. Currently only allow one search_solution_use_case per control.", - "items": { - "enum": [ - "SEARCH_SOLUTION_USE_CASE_UNSPECIFIED", - "SEARCH_SOLUTION_USE_CASE_SEARCH", - "SEARCH_SOLUTION_USE_CASE_BROWSE" - ], - "enumDescriptions": [ - "The value when it's unspecified. Defaults to SEARCH.", - "Search use case. Expects the traffic has a non-empty query.", - "Browse use case. Expects the traffic has an empty query." - ], - "type": "string" - }, - "type": "array" - }, "solutionTypes": { "description": "Required. Immutable. The solution types that the serving config is used for. Currently we support setting only one type of solution at creation time. Only `SOLUTION_TYPE_SEARCH` value is supported at the moment. If no solution type is provided at creation time, will default to SOLUTION_TYPE_SEARCH.", "items": { @@ -3573,7 +3556,7 @@ }, "userEvent": { "$ref": "GoogleCloudRetailV2betaUserEvent", - "description": "Required. Context about the user, what they are looking at and what action they took to trigger the predict request. Note that this user event detail won't be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging." + "description": "Required. Context about the user, what they are looking at and what action they took to trigger the predict request. Note that this user event detail won't be ingested to userEvent logs. Thus, a separate userEvent write request is required for event logging. Don't set UserEvent.visitor_id or UserInfo.user_id to the same fixed ID for different users. If you are trying to receive non-personalized recommendations (not recommended; this can negatively impact model performance), instead set UserEvent.visitor_id to a random unique ID and leave UserInfo.user_id unset." }, "validateOnly": { "description": "Use validate only mode for this prediction query. If set to true, a dummy model will be used that returns arbitrary products. Note that the validate only mode should only be used for testing the API, or if the model is not ready.", @@ -3950,11 +3933,11 @@ "id": "GoogleCloudRetailV2betaProductLevelConfig", "properties": { "ingestionProductType": { - "description": "The type of Products allowed to be ingested into the catalog. Acceptable values are: * `primary` (default): You can ingest Products of all types. When ingesting a Product, its type will default to Product.Type.PRIMARY if unset. * `variant`: You can only ingest Product.Type.VARIANT Products. This means Product.primary_product_id cannot be empty. If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. If this field is `variant` and merchant_center_product_id_field is `itemGroupId`, an INVALID_ARGUMENT error is returned. See [Using product levels](https://cloud.google.com/retail/recommendations-ai/docs/catalog#product-levels) for more details.", + "description": "The type of Products allowed to be ingested into the catalog. Acceptable values are: * `primary` (default): You can ingest Products of all types. When ingesting a Product, its type will default to Product.Type.PRIMARY if unset. * `variant` (incompatible with Retail Search): You can only ingest Product.Type.VARIANT Products. This means Product.primary_product_id cannot be empty. If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. If this field is `variant` and merchant_center_product_id_field is `itemGroupId`, an INVALID_ARGUMENT error is returned. See [Product levels](https://cloud.google.com/retail/docs/catalog#product-levels) for more details.", "type": "string" }, "merchantCenterProductIdField": { - "description": "Which field of [Merchant Center Product](/bigquery-transfer/docs/merchant-center-products-schema) should be imported as Product.id. Acceptable values are: * `offerId` (default): Import `offerId` as the product ID. * `itemGroupId`: Import `itemGroupId` as the product ID. Notice that Retail API will choose one item from the ones with the same `itemGroupId`, and use it to represent the item group. If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. If this field is `itemGroupId` and ingestion_product_type is `variant`, an INVALID_ARGUMENT error is returned. See [Using product levels](https://cloud.google.com/retail/recommendations-ai/docs/catalog#product-levels) for more details.", + "description": "Which field of [Merchant Center Product](/bigquery-transfer/docs/merchant-center-products-schema) should be imported as Product.id. Acceptable values are: * `offerId` (default): Import `offerId` as the product ID. * `itemGroupId`: Import `itemGroupId` as the product ID. Notice that Retail API will choose one item from the ones with the same `itemGroupId`, and use it to represent the item group. If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. If this field is `itemGroupId` and ingestion_product_type is `variant`, an INVALID_ARGUMENT error is returned. See [Product levels](https://cloud.google.com/retail/docs/catalog#product-levels) for more details.", "type": "string" } }, @@ -4458,7 +4441,7 @@ "description": "The specification for personalization." }, "query": { - "description": "Raw search query.", + "description": "Raw search query. If this field is empty, the request is considered a category browsing request and returned results are based on filter and page_categories.", "type": "string" }, "queryExpansionSpec": { @@ -5091,7 +5074,7 @@ "description": "User information." }, "visitorId": { - "description": "Required. A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor log in/out of the website. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. The field should not contain PII or user-data. We recommend to use Google Analystics [Client ID](https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#clientId) for this field.", + "description": "Required. A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor log in/out of the website. Don't set the field to the same fixed ID for different users. This mixes the event history of those users together, which results in degraded model quality. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. The field should not contain PII or user-data. We recommend to use Google Analystics [Client ID](https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#clientId) for this field.", "type": "string" } }, @@ -5164,7 +5147,7 @@ "type": "string" }, "userId": { - "description": "Highly recommended for logged-in users. Unique identifier for logged-in user, such as a user name. Always use a hashed value for this ID. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", + "description": "Highly recommended for logged-in users. Unique identifier for logged-in user, such as a user name. Don't set for anonymous users. Always use a hashed value for this ID. Don't set the field to the same fixed ID for different users. This mixes the event history of those users together, which results in degraded model quality. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.", "type": "string" } }, diff --git a/retail/v2beta/retail-gen.go b/retail/v2beta/retail-gen.go index 5268404e536..5c526fce7f2 100644 --- a/retail/v2beta/retail-gen.go +++ b/retail/v2beta/retail-gen.go @@ -2554,21 +2554,6 @@ type GoogleCloudRetailV2betaControl struct { // query full matches "Running Shoes". Rule *GoogleCloudRetailV2betaRule `json:"rule,omitempty"` - // SearchSolutionUseCase: Required. Specifies the use case for the - // control. Affects what condition fields can be set. Only settable by - // search controls. Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if - // not specified. Currently only allow one search_solution_use_case per - // control. - // - // Possible values: - // "SEARCH_SOLUTION_USE_CASE_UNSPECIFIED" - The value when it's - // unspecified. Defaults to SEARCH. - // "SEARCH_SOLUTION_USE_CASE_SEARCH" - Search use case. Expects the - // traffic has a non-empty query. - // "SEARCH_SOLUTION_USE_CASE_BROWSE" - Browse use case. Expects the - // traffic has an empty query. - SearchSolutionUseCase []string `json:"searchSolutionUseCase,omitempty"` - // SolutionTypes: Required. Immutable. The solution types that the // serving config is used for. Currently we support setting only one // type of solution at creation time. Only `SOLUTION_TYPE_SEARCH` value @@ -3747,7 +3732,12 @@ type GoogleCloudRetailV2betaPredictRequest struct { // UserEvent: Required. Context about the user, what they are looking at // and what action they took to trigger the predict request. Note that // this user event detail won't be ingested to userEvent logs. Thus, a - // separate userEvent write request is required for event logging. + // separate userEvent write request is required for event logging. Don't + // set UserEvent.visitor_id or UserInfo.user_id to the same fixed ID for + // different users. If you are trying to receive non-personalized + // recommendations (not recommended; this can negatively impact model + // performance), instead set UserEvent.visitor_id to a random unique ID + // and leave UserInfo.user_id unset. UserEvent *GoogleCloudRetailV2betaUserEvent `json:"userEvent,omitempty"` // ValidateOnly: Use validate only mode for this prediction query. If @@ -4450,15 +4440,15 @@ type GoogleCloudRetailV2betaProductLevelConfig struct { // IngestionProductType: The type of Products allowed to be ingested // into the catalog. Acceptable values are: * `primary` (default): You // can ingest Products of all types. When ingesting a Product, its type - // will default to Product.Type.PRIMARY if unset. * `variant`: You can - // only ingest Product.Type.VARIANT Products. This means - // Product.primary_product_id cannot be empty. If this field is set to - // an invalid value other than these, an INVALID_ARGUMENT error is - // returned. If this field is `variant` and - // merchant_center_product_id_field is `itemGroupId`, an - // INVALID_ARGUMENT error is returned. See Using product levels - // (https://cloud.google.com/retail/recommendations-ai/docs/catalog#product-levels) - // for more details. + // will default to Product.Type.PRIMARY if unset. * `variant` + // (incompatible with Retail Search): You can only ingest + // Product.Type.VARIANT Products. This means Product.primary_product_id + // cannot be empty. If this field is set to an invalid value other than + // these, an INVALID_ARGUMENT error is returned. If this field is + // `variant` and merchant_center_product_id_field is `itemGroupId`, an + // INVALID_ARGUMENT error is returned. See Product levels + // (https://cloud.google.com/retail/docs/catalog#product-levels) for + // more details. IngestionProductType string `json:"ingestionProductType,omitempty"` // MerchantCenterProductIdField: Which field of Merchant Center Product @@ -4470,9 +4460,9 @@ type GoogleCloudRetailV2betaProductLevelConfig struct { // represent the item group. If this field is set to an invalid value // other than these, an INVALID_ARGUMENT error is returned. If this // field is `itemGroupId` and ingestion_product_type is `variant`, an - // INVALID_ARGUMENT error is returned. See Using product levels - // (https://cloud.google.com/retail/recommendations-ai/docs/catalog#product-levels) - // for more details. + // INVALID_ARGUMENT error is returned. See Product levels + // (https://cloud.google.com/retail/docs/catalog#product-levels) for + // more details. MerchantCenterProductIdField string `json:"merchantCenterProductIdField,omitempty"` // ForceSendFields is a list of field names (e.g. @@ -5506,7 +5496,9 @@ type GoogleCloudRetailV2betaSearchRequest struct { // PersonalizationSpec: The specification for personalization. PersonalizationSpec *GoogleCloudRetailV2betaSearchRequestPersonalizationSpec `json:"personalizationSpec,omitempty"` - // Query: Raw search query. + // Query: Raw search query. If this field is empty, the request is + // considered a category browsing request and returned results are based + // on filter and page_categories. Query string `json:"query,omitempty"` // QueryExpansionSpec: The query expansion specification that specifies @@ -6700,10 +6692,12 @@ type GoogleCloudRetailV2betaUserEvent struct { // example, this could be implemented with an HTTP cookie, which should // be able to uniquely identify a visitor on a single device. This // unique identifier should not change if the visitor log in/out of the - // website. The field must be a UTF-8 encoded string with a length limit - // of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. - // The field should not contain PII or user-data. We recommend to use - // Google Analystics Client ID + // website. Don't set the field to the same fixed ID for different + // users. This mixes the event history of those users together, which + // results in degraded model quality. The field must be a UTF-8 encoded + // string with a length limit of 128 characters. Otherwise, an + // INVALID_ARGUMENT error is returned. The field should not contain PII + // or user-data. We recommend to use Google Analystics Client ID // (https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#clientId) // for this field. VisitorId string `json:"visitorId,omitempty"` @@ -6868,9 +6862,12 @@ type GoogleCloudRetailV2betaUserInfo struct { UserAgent string `json:"userAgent,omitempty"` // UserId: Highly recommended for logged-in users. Unique identifier for - // logged-in user, such as a user name. Always use a hashed value for - // this ID. The field must be a UTF-8 encoded string with a length limit - // of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. + // logged-in user, such as a user name. Don't set for anonymous users. + // Always use a hashed value for this ID. Don't set the field to the + // same fixed ID for different users. This mixes the event history of + // those users together, which results in degraded model quality. The + // field must be a UTF-8 encoded string with a length limit of 128 + // characters. Otherwise, an INVALID_ARGUMENT error is returned. UserId string `json:"userId,omitempty"` // ForceSendFields is a list of field names (e.g. "DirectUserRequest") @@ -10435,7 +10432,10 @@ func (c *ProjectsLocationsCatalogsBranchesProductsPatchCall) AllowMissing(allowM // only fields are NOT supported. If not set, all supported fields (the // fields that are neither immutable nor output only) are updated. If an // unsupported or unknown field is provided, an INVALID_ARGUMENT error -// is returned. +// is returned. The attribute key can be updated by setting the mask +// path as "attributes.${key_name}". If a key name is present in the +// mask but not in the patching product from the request, this key will +// be deleted after the update. func (c *ProjectsLocationsCatalogsBranchesProductsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCatalogsBranchesProductsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c @@ -10553,7 +10553,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsPatchCall) Do(opts ...googleap // "type": "string" // }, // "updateMask": { - // "description": "Indicates which fields in the provided Product to update. The immutable and output only fields are NOT supported. If not set, all supported fields (the fields that are neither immutable nor output only) are updated. If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned.", + // "description": "Indicates which fields in the provided Product to update. The immutable and output only fields are NOT supported. If not set, all supported fields (the fields that are neither immutable nor output only) are updated. If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned. The attribute key can be updated by setting the mask path as \"attributes.${key_name}\". If a key name is present in the mask but not in the patching product from the request, this key will be deleted after the update.", // "format": "google-fieldmask", // "location": "query", // "type": "string" @@ -12384,15 +12384,18 @@ type ProjectsLocationsCatalogsPlacementsPredictCall struct { // Predict: Makes a recommendation prediction. // // - placement: Full resource name of the format: -// {name=projects/*/locations/global/catalogs/default_catalog/placement -// s/*} or // {name=projects/*/locations/global/catalogs/default_catalog/servingCo -// nfigs/*} The ID of the Recommendations AI placement. Before you can -// request predictions from your model, you must create at least one -// placement for it. For more information, see Managing placements -// (https://cloud.google.com/retail/recommendations-ai/docs/manage-placements). -// The full list of available placements can be seen at -// https://console.cloud.google.com/recommendation/catalogs/default_catalog/placements. +// nfigs/*} or +// {name=projects/*/locations/global/catalogs/default_catalog/placement +// s/*}. We recommend using the `servingConfigs` resource. +// `placements` is a legacy resource. The ID of the Recommendations AI +// serving config or placement. Before you can request predictions +// from your model, you must create at least one serving config or +// placement for it. For more information, see [Managing serving +// configurations]. +// (https://cloud.google.com/retail/docs/manage-configs). The full +// list of available serving configs can be seen at +// https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs. func (r *ProjectsLocationsCatalogsPlacementsService) Predict(placement string, googlecloudretailv2betapredictrequest *GoogleCloudRetailV2betaPredictRequest) *ProjectsLocationsCatalogsPlacementsPredictCall { c := &ProjectsLocationsCatalogsPlacementsPredictCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.placement = placement @@ -12501,7 +12504,7 @@ func (c *ProjectsLocationsCatalogsPlacementsPredictCall) Do(opts ...googleapi.Ca // ], // "parameters": { // "placement": { - // "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/placements/*} or {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} The ID of the Recommendations AI placement. Before you can request predictions from your model, you must create at least one placement for it. For more information, see [Managing placements](https://cloud.google.com/retail/recommendations-ai/docs/manage-placements). The full list of available placements can be seen at https://console.cloud.google.com/recommendation/catalogs/default_catalog/placements", + // "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} or {name=projects/*/locations/global/catalogs/default_catalog/placements/*}. We recommend using the `servingConfigs` resource. `placements` is a legacy resource. The ID of the Recommendations AI serving config or placement. Before you can request predictions from your model, you must create at least one serving config or placement for it. For more information, see [Managing serving configurations]. (https://cloud.google.com/retail/docs/manage-configs). The full list of available serving configs can be seen at https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/placements/[^/]+$", // "required": true, @@ -12537,12 +12540,13 @@ type ProjectsLocationsCatalogsPlacementsSearchCall struct { // who have Retail Search enabled. Please enable Retail Search on Cloud // Console before using this feature. // -// - placement: The resource name of the search engine placement, such -// as -// `projects/*/locations/global/catalogs/default_catalog/placements/def -// ault_search` or +// - placement: The resource name of the Retail Search serving config, +// such as // `projects/*/locations/global/catalogs/default_catalog/servingConfigs -// /default_serving_config` This field is used to identify the serving +// /default_serving_config` or the name of the legacy placement +// resource, such as +// `projects/*/locations/global/catalogs/default_catalog/placements/def +// ault_search`. This field is used to identify the serving // configuration name and the set of models that will be used to make // the search. func (r *ProjectsLocationsCatalogsPlacementsService) Search(placement string, googlecloudretailv2betasearchrequest *GoogleCloudRetailV2betaSearchRequest) *ProjectsLocationsCatalogsPlacementsSearchCall { @@ -12653,7 +12657,7 @@ func (c *ProjectsLocationsCatalogsPlacementsSearchCall) Do(opts ...googleapi.Cal // ], // "parameters": { // "placement": { - // "description": "Required. The resource name of the search engine placement, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search` or `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` This field is used to identify the serving configuration name and the set of models that will be used to make the search.", + // "description": "Required. The resource name of the Retail Search serving config, such as `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` or the name of the legacy placement resource, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search`. This field is used to identify the serving configuration name and the set of models that will be used to make the search.", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/placements/[^/]+$", // "required": true, @@ -13663,15 +13667,18 @@ type ProjectsLocationsCatalogsServingConfigsPredictCall struct { // Predict: Makes a recommendation prediction. // // - placement: Full resource name of the format: -// {name=projects/*/locations/global/catalogs/default_catalog/placement -// s/*} or // {name=projects/*/locations/global/catalogs/default_catalog/servingCo -// nfigs/*} The ID of the Recommendations AI placement. Before you can -// request predictions from your model, you must create at least one -// placement for it. For more information, see Managing placements -// (https://cloud.google.com/retail/recommendations-ai/docs/manage-placements). -// The full list of available placements can be seen at -// https://console.cloud.google.com/recommendation/catalogs/default_catalog/placements. +// nfigs/*} or +// {name=projects/*/locations/global/catalogs/default_catalog/placement +// s/*}. We recommend using the `servingConfigs` resource. +// `placements` is a legacy resource. The ID of the Recommendations AI +// serving config or placement. Before you can request predictions +// from your model, you must create at least one serving config or +// placement for it. For more information, see [Managing serving +// configurations]. +// (https://cloud.google.com/retail/docs/manage-configs). The full +// list of available serving configs can be seen at +// https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs. func (r *ProjectsLocationsCatalogsServingConfigsService) Predict(placement string, googlecloudretailv2betapredictrequest *GoogleCloudRetailV2betaPredictRequest) *ProjectsLocationsCatalogsServingConfigsPredictCall { c := &ProjectsLocationsCatalogsServingConfigsPredictCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.placement = placement @@ -13780,7 +13787,7 @@ func (c *ProjectsLocationsCatalogsServingConfigsPredictCall) Do(opts ...googleap // ], // "parameters": { // "placement": { - // "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/placements/*} or {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} The ID of the Recommendations AI placement. Before you can request predictions from your model, you must create at least one placement for it. For more information, see [Managing placements](https://cloud.google.com/retail/recommendations-ai/docs/manage-placements). The full list of available placements can be seen at https://console.cloud.google.com/recommendation/catalogs/default_catalog/placements", + // "description": "Required. Full resource name of the format: {name=projects/*/locations/global/catalogs/default_catalog/servingConfigs/*} or {name=projects/*/locations/global/catalogs/default_catalog/placements/*}. We recommend using the `servingConfigs` resource. `placements` is a legacy resource. The ID of the Recommendations AI serving config or placement. Before you can request predictions from your model, you must create at least one serving config or placement for it. For more information, see [Managing serving configurations]. (https://cloud.google.com/retail/docs/manage-configs). The full list of available serving configs can be seen at https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/servingConfigs/[^/]+$", // "required": true, @@ -13963,12 +13970,13 @@ type ProjectsLocationsCatalogsServingConfigsSearchCall struct { // who have Retail Search enabled. Please enable Retail Search on Cloud // Console before using this feature. // -// - placement: The resource name of the search engine placement, such -// as -// `projects/*/locations/global/catalogs/default_catalog/placements/def -// ault_search` or +// - placement: The resource name of the Retail Search serving config, +// such as // `projects/*/locations/global/catalogs/default_catalog/servingConfigs -// /default_serving_config` This field is used to identify the serving +// /default_serving_config` or the name of the legacy placement +// resource, such as +// `projects/*/locations/global/catalogs/default_catalog/placements/def +// ault_search`. This field is used to identify the serving // configuration name and the set of models that will be used to make // the search. func (r *ProjectsLocationsCatalogsServingConfigsService) Search(placement string, googlecloudretailv2betasearchrequest *GoogleCloudRetailV2betaSearchRequest) *ProjectsLocationsCatalogsServingConfigsSearchCall { @@ -14079,7 +14087,7 @@ func (c *ProjectsLocationsCatalogsServingConfigsSearchCall) Do(opts ...googleapi // ], // "parameters": { // "placement": { - // "description": "Required. The resource name of the search engine placement, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search` or `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` This field is used to identify the serving configuration name and the set of models that will be used to make the search.", + // "description": "Required. The resource name of the Retail Search serving config, such as `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` or the name of the legacy placement resource, such as `projects/*/locations/global/catalogs/default_catalog/placements/default_search`. This field is used to identify the serving configuration name and the set of models that will be used to make the search.", // "location": "path", // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/servingConfigs/[^/]+$", // "required": true, diff --git a/servicemanagement/v1/servicemanagement-api.json b/servicemanagement/v1/servicemanagement-api.json index bcefc1bb1e6..3696c4e27e6 100644 --- a/servicemanagement/v1/servicemanagement-api.json +++ b/servicemanagement/v1/servicemanagement-api.json @@ -829,7 +829,7 @@ } } }, - "revision": "20220401", + "revision": "20220408", "rootUrl": "https://servicemanagement.googleapis.com/", "schemas": { "Advice": { @@ -968,7 +968,7 @@ "type": "string" }, "jwtLocations": { - "description": "Defines the locations to extract the JWT. JWT locations can be either from HTTP headers or URL query parameters. The rule is that the first match wins. The checking order is: checking all headers first, then URL query parameters. If not specified, default to use following 3 locations: 1) Authorization: Bearer 2) x-goog-iap-jwt-assertion 3) access_token query parameter Default locations can be specified as followings: jwt_locations: - header: Authorization value_prefix: \"Bearer \" - header: x-goog-iap-jwt-assertion - query: access_token", + "description": "Defines the locations to extract the JWT. For now it is only used by the Cloud Endpoints to store the OpenAPI extension [x-google-jwt-locations] (https://cloud.google.com/endpoints/docs/openapi/openapi-extensions#x-google-jwt-locations) JWT locations can be one of HTTP headers, URL query parameters or cookies. The rule is that the first match wins. If not specified, default to use following 3 locations: 1) Authorization: Bearer 2) x-goog-iap-jwt-assertion 3) access_token query parameter Default locations can be specified as followings: jwt_locations: - header: Authorization value_prefix: \"Bearer \" - header: x-goog-iap-jwt-assertion - query: access_token", "items": { "$ref": "JwtLocation" }, @@ -1144,7 +1144,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" }, @@ -1856,6 +1856,10 @@ "description": "Specifies a location to extract JWT from an API request.", "id": "JwtLocation", "properties": { + "cookie": { + "description": "Specifies cookie name to extract JWT token.", + "type": "string" + }, "header": { "description": "Specifies HTTP header name to extract JWT token.", "type": "string" @@ -2827,7 +2831,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\"`", @@ -3006,7 +3010,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/servicemanagement/v1/servicemanagement-gen.go b/servicemanagement/v1/servicemanagement-gen.go index 536c6ca38f2..8d17ceb3641 100644 --- a/servicemanagement/v1/servicemanagement-gen.go +++ b/servicemanagement/v1/servicemanagement-gen.go @@ -457,11 +457,13 @@ type AuthProvider struct { // https://www.googleapis.com/oauth2/v1/certs JwksUri string `json:"jwksUri,omitempty"` - // JwtLocations: Defines the locations to extract the JWT. JWT locations - // can be either from HTTP headers or URL query parameters. The rule is - // that the first match wins. The checking order is: checking all - // headers first, then URL query parameters. If not specified, default - // to use following 3 locations: 1) Authorization: Bearer 2) + // JwtLocations: Defines the locations to extract the JWT. For now it is + // only used by the Cloud Endpoints to store the OpenAPI extension + // [x-google-jwt-locations] + // (https://cloud.google.com/endpoints/docs/openapi/openapi-extensions#x-google-jwt-locations) + // JWT locations can be one of HTTP headers, URL query parameters or + // cookies. The rule is that the first match wins. If not specified, + // default to use following 3 locations: 1) Authorization: Bearer 2) // x-goog-iap-jwt-assertion 3) access_token query parameter Default // locations can be specified as followings: jwt_locations: - header: // Authorization value_prefix: "Bearer " - header: @@ -868,8 +870,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 @@ -2292,6 +2294,9 @@ func (s *HttpRule) MarshalJSON() ([]byte, error) { // JwtLocation: Specifies a location to extract JWT from an API request. type JwtLocation struct { + // Cookie: Specifies cookie name to extract JWT token. + Cookie string `json:"cookie,omitempty"` + // Header: Specifies HTTP header name to extract JWT token. Header string `json:"header,omitempty"` @@ -2307,7 +2312,7 @@ type JwtLocation struct { // value_prefix="Bearer " with a space at the end. ValuePrefix string `json:"valuePrefix,omitempty"` - // ForceSendFields is a list of field names (e.g. "Header") to + // ForceSendFields is a list of field names (e.g. "Cookie") 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 @@ -2315,7 +2320,7 @@ type JwtLocation struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Header") to include in API + // NullFields is a list of field names (e.g. "Cookie") 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 @@ -4134,7 +4139,7 @@ func (s *Service) 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"` @@ -4499,7 +4504,7 @@ func (s *SystemParameters) 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"` diff --git a/speech/v1/speech-api.json b/speech/v1/speech-api.json index c837dd166e2..f4f47c52def 100644 --- a/speech/v1/speech-api.json +++ b/speech/v1/speech-api.json @@ -524,7 +524,7 @@ } } }, - "revision": "20220310", + "revision": "20220411", "rootUrl": "https://speech.googleapis.com/", "schemas": { "ClassItem": { @@ -591,7 +591,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/speech/v1/speech-gen.go b/speech/v1/speech-gen.go index 67b7f85c6da..6e3fcd1658a 100644 --- a/speech/v1/speech-gen.go +++ b/speech/v1/speech-gen.go @@ -355,8 +355,7 @@ func (s *CustomClass) 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. diff --git a/speech/v1p1beta1/speech-api.json b/speech/v1p1beta1/speech-api.json index 6db55f929eb..73c02ea20bf 100644 --- a/speech/v1p1beta1/speech-api.json +++ b/speech/v1p1beta1/speech-api.json @@ -524,7 +524,7 @@ } } }, - "revision": "20220310", + "revision": "20220411", "rootUrl": "https://speech.googleapis.com/", "schemas": { "ClassItem": { @@ -591,7 +591,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/speech/v1p1beta1/speech-gen.go b/speech/v1p1beta1/speech-gen.go index 552df6012f5..54a2ce78c06 100644 --- a/speech/v1p1beta1/speech-gen.go +++ b/speech/v1p1beta1/speech-gen.go @@ -355,8 +355,7 @@ func (s *CustomClass) 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. From 95e21aacbdd5088a7d36d85a5f1f487f834ba6ad Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Fri, 15 Apr 2022 07:50:08 -0700 Subject: [PATCH 12/17] feat(all): auto-regenerate discovery clients (#1513) --- cloudbuild/v1/cloudbuild-api.json | 4 +- cloudbuild/v1/cloudbuild-gen.go | 4 +- compute/v0.alpha/compute-api.json | 90 ++++--- compute/v0.alpha/compute-gen.go | 245 ++++++++++-------- compute/v1/compute-api.json | 56 ++-- compute/v1/compute-gen.go | 170 ++++++------ container/v1/container-api.json | 51 +++- container/v1/container-gen.go | 93 ++++++- container/v1beta1/container-api.json | 13 +- container/v1beta1/container-gen.go | 19 +- datacatalog/v1/datacatalog-api.json | 10 +- datacatalog/v1/datacatalog-gen.go | 11 +- datacatalog/v1beta1/datacatalog-api.json | 10 +- datacatalog/v1beta1/datacatalog-gen.go | 11 +- datamigration/v1/datamigration-api.json | 10 +- datamigration/v1/datamigration-gen.go | 14 +- datamigration/v1beta1/datamigration-api.json | 10 +- datamigration/v1beta1/datamigration-gen.go | 14 +- dialogflow/v2/dialogflow-api.json | 14 +- dialogflow/v2/dialogflow-gen.go | 32 ++- dialogflow/v2beta1/dialogflow-api.json | 14 +- dialogflow/v2beta1/dialogflow-gen.go | 32 ++- dialogflow/v3/dialogflow-api.json | 20 +- dialogflow/v3/dialogflow-gen.go | 40 ++- dialogflow/v3beta1/dialogflow-api.json | 20 +- dialogflow/v3beta1/dialogflow-gen.go | 40 ++- gkehub/v1beta1/gkehub-api.json | 8 +- gkehub/v1beta1/gkehub-gen.go | 8 +- pubsub/v1/pubsub-api.json | 8 +- pubsub/v1/pubsub-gen.go | 8 +- pubsub/v1beta2/pubsub-api.json | 8 +- pubsub/v1beta2/pubsub-gen.go | 8 +- run/v1alpha1/run-api.json | 6 +- run/v1alpha1/run-gen.go | 9 +- run/v2/run-api.json | 14 +- run/v2/run-gen.go | 26 +- servicedirectory/v1/servicedirectory-api.json | 10 +- servicedirectory/v1/servicedirectory-gen.go | 14 +- .../v1beta1/servicedirectory-api.json | 10 +- .../v1beta1/servicedirectory-gen.go | 14 +- vmmigration/v1/vmmigration-api.json | 28 +- vmmigration/v1/vmmigration-gen.go | 64 ++++- vmmigration/v1alpha1/vmmigration-api.json | 28 +- vmmigration/v1alpha1/vmmigration-gen.go | 64 ++++- workflows/v1beta/workflows-api.json | 4 +- workflows/v1beta/workflows-gen.go | 6 +- 46 files changed, 875 insertions(+), 517 deletions(-) diff --git a/cloudbuild/v1/cloudbuild-api.json b/cloudbuild/v1/cloudbuild-api.json index 33579f85b81..af7e4f5129d 100644 --- a/cloudbuild/v1/cloudbuild-api.json +++ b/cloudbuild/v1/cloudbuild-api.json @@ -745,7 +745,7 @@ ] }, "removeBitbucketServerConnectedRepository": { - "description": "Remove a Bitbucket Server repository from an given BitbucketServerConfig’s connected repositories. This API is experimental.", + "description": "Remove a Bitbucket Server repository from a given BitbucketServerConfig's connected repositories. This API is experimental.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bitbucketServerConfigs/{bitbucketServerConfigsId}:removeBitbucketServerConnectedRepository", "httpMethod": "POST", "id": "cloudbuild.projects.locations.bitbucketServerConfigs.removeBitbucketServerConnectedRepository", @@ -2011,7 +2011,7 @@ } } }, - "revision": "20220322", + "revision": "20220407", "rootUrl": "https://cloudbuild.googleapis.com/", "schemas": { "ApprovalConfig": { diff --git a/cloudbuild/v1/cloudbuild-gen.go b/cloudbuild/v1/cloudbuild-gen.go index cac623b6aeb..d6fbb54254f 100644 --- a/cloudbuild/v1/cloudbuild-gen.go +++ b/cloudbuild/v1/cloudbuild-gen.go @@ -7679,7 +7679,7 @@ type ProjectsLocationsBitbucketServerConfigsRemoveBitbucketServerConnectedReposi } // RemoveBitbucketServerConnectedRepository: Remove a Bitbucket Server -// repository from an given BitbucketServerConfig’s connected +// repository from a given BitbucketServerConfig's connected // repositories. This API is experimental. // // - config: The name of the `BitbucketServerConfig` to remove a @@ -7784,7 +7784,7 @@ func (c *ProjectsLocationsBitbucketServerConfigsRemoveBitbucketServerConnectedRe } return ret, nil // { - // "description": "Remove a Bitbucket Server repository from an given BitbucketServerConfig’s connected repositories. This API is experimental.", + // "description": "Remove a Bitbucket Server repository from a given BitbucketServerConfig's connected repositories. This API is experimental.", // "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/bitbucketServerConfigs/{bitbucketServerConfigsId}:removeBitbucketServerConnectedRepository", // "httpMethod": "POST", // "id": "cloudbuild.projects.locations.bitbucketServerConfigs.removeBitbucketServerConnectedRepository", diff --git a/compute/v0.alpha/compute-api.json b/compute/v0.alpha/compute-api.json index 70830187510..947e92d645f 100644 --- a/compute/v0.alpha/compute-api.json +++ b/compute/v0.alpha/compute-api.json @@ -8194,7 +8194,7 @@ ] }, "createInstances": { - "description": "Creates instances with per-instance configs in this managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method.", + "description": "Creates instances with per-instance configurations in this managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method.", "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/createInstances", "httpMethod": "POST", "id": "compute.instanceGroupManagers.createInstances", @@ -8335,7 +8335,7 @@ ] }, "deletePerInstanceConfigs": { - "description": "Deletes selected per-instance configs for the managed instance group.", + "description": "Deletes selected per-instance configurations for the managed instance group.", "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", "httpMethod": "POST", "id": "compute.instanceGroupManagers.deletePerInstanceConfigs", @@ -8660,7 +8660,7 @@ ] }, "listPerInstanceConfigs": { - "description": "Lists all of the per-instance configs defined for the managed instance group. The orderBy query parameter is not supported.", + "description": "Lists all of the per-instance configurations defined for the managed instance group. The orderBy query parameter is not supported.", "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", "httpMethod": "POST", "id": "compute.instanceGroupManagers.listPerInstanceConfigs", @@ -8777,7 +8777,7 @@ ] }, "patchPerInstanceConfigs": { - "description": "Inserts or patches per-instance configs for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", + "description": "Inserts or patches per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", "httpMethod": "POST", "id": "compute.instanceGroupManagers.patchPerInstanceConfigs", @@ -9404,7 +9404,7 @@ ] }, "updatePerInstanceConfigs": { - "description": "Inserts or updates per-instance configs for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", + "description": "Inserts or updates per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", "httpMethod": "POST", "id": "compute.instanceGroupManagers.updatePerInstanceConfigs", @@ -23620,7 +23620,7 @@ ] }, "createInstances": { - "description": "Creates instances with per-instance configs in this regional managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method.", + "description": "Creates instances with per-instance configurations in this regional managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method.", "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/createInstances", "httpMethod": "POST", "id": "compute.regionInstanceGroupManagers.createInstances", @@ -23761,7 +23761,7 @@ ] }, "deletePerInstanceConfigs": { - "description": "Deletes selected per-instance configs for the managed instance group.", + "description": "Deletes selected per-instance configurations for the managed instance group.", "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", "httpMethod": "POST", "id": "compute.regionInstanceGroupManagers.deletePerInstanceConfigs", @@ -24086,7 +24086,7 @@ ] }, "listPerInstanceConfigs": { - "description": "Lists all of the per-instance configs defined for the managed instance group. The orderBy query parameter is not supported.", + "description": "Lists all of the per-instance configurations defined for the managed instance group. The orderBy query parameter is not supported.", "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", "httpMethod": "POST", "id": "compute.regionInstanceGroupManagers.listPerInstanceConfigs", @@ -24203,7 +24203,7 @@ ] }, "patchPerInstanceConfigs": { - "description": "Inserts or patches per-instance configs for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", + "description": "Inserts or patches per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", "httpMethod": "POST", "id": "compute.regionInstanceGroupManagers.patchPerInstanceConfigs", @@ -24831,7 +24831,7 @@ ] }, "updatePerInstanceConfigs": { - "description": "Inserts or updates per-instance configs for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", + "description": "Inserts or updates per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", "httpMethod": "POST", "id": "compute.regionInstanceGroupManagers.updatePerInstanceConfigs", @@ -38660,7 +38660,7 @@ } } }, - "revision": "20220322", + "revision": "20220405", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -42530,7 +42530,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" }, @@ -43364,6 +43364,20 @@ "description": "A set of Confidential Instance options.", "id": "ConfidentialInstanceConfig", "properties": { + "confidentialInstanceType": { + "description": "Defines the type of technology used by the confidential instance.", + "enum": [ + "CONFIDENTIAL_INSTANCE_TYPE_UNSPECIFIED", + "SEV", + "SEV_SNP" + ], + "enumDescriptions": [ + "No type specified. Do not use this value.", + "AMD Secure Encrypted Virtualization.", + "AMD Secure Encrypted Virtualization - Secure Nested Paging." + ], + "type": "string" + }, "enableConfidentialCompute": { "description": "Defines whether the instance should have confidential compute enabled.", "type": "boolean" @@ -44192,6 +44206,7 @@ "state": { "enum": [ "ACTIVE", + "CREATED", "STARTING", "STATE_UNSPECIFIED", "STOPPED", @@ -44199,6 +44214,7 @@ ], "enumDescriptions": [ "Replication is active.", + "Secondary disk is created and is waiting for replication to start.", "Replication is starting.", "", "Replication is stopped.", @@ -47353,6 +47369,7 @@ "MULTI_IP_SUBNET", "SECURE_BOOT", "SEV_CAPABLE", + "SEV_SNP_CAPABLE", "UEFI_COMPATIBLE", "VIRTIO_SCSI_MULTIQUEUE", "WINDOWS" @@ -47366,6 +47383,7 @@ "", "", "", + "", "" ], "type": "string" @@ -50548,7 +50566,7 @@ "properties": { "allInstancesConfig": { "$ref": "InstanceGroupManagerAllInstancesConfig", - "description": "Specifies the instances configs overrides that should be applied for all instances in the MIG." + "description": "Specifies configuration that overrides the instance template configuration for the group." }, "autoHealingPolicies": { "description": "The autohealing policy for this managed instance group. You can specify only one value.", @@ -50925,7 +50943,7 @@ "properties": { "properties": { "$ref": "InstancePropertiesPatch", - "description": "Properties for instances that are created using this instances config. You can add or modify properties using the instanceGroupManagers.patch or regionInstanceGroupManagers.patch. After setting instances_config, you must update your instances to use it; for example, you can use the applyUpdatesToInstances method." + "description": "Properties to set on all instances in the group. You can add or modify properties using the instanceGroupManagers.patch or regionInstanceGroupManagers.patch. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration. To apply the configuration, set the group's updatePolicy.type field to use proactive updates or use the applyUpdatesToInstances method." } }, "type": "object" @@ -51134,7 +51152,7 @@ "properties": { "allInstancesConfig": { "$ref": "InstanceGroupManagerStatusAllInstancesConfig", - "description": "[Output Only] A status of consistency of Instances' config applied to instances with Instances' config defined in managed instance group." + "description": "[Output only] Status of all-instances configuration on the group." }, "autoscaler": { "description": "[Output Only] The URL of the Autoscaler that targets this instance group manager.", @@ -51159,11 +51177,11 @@ "id": "InstanceGroupManagerStatusAllInstancesConfig", "properties": { "currentRevision": { - "description": "[Output Only] Current instances' config revision. This value is in RFC3339 text format.", + "description": "[Output Only] Current all-instances configuration revision. This value is in RFC3339 text format.", "type": "string" }, "effective": { - "description": "[Output Only] A bit indicating whether instances' config has been applied to all managed instances in managed instance group.", + "description": "[Output Only] A bit indicating whether this configuration has been applied to all managed instances in the group.", "type": "boolean" } }, @@ -51173,16 +51191,16 @@ "id": "InstanceGroupManagerStatusStateful", "properties": { "hasStatefulConfig": { - "description": "[Output Only] A bit indicating whether the managed instance group has stateful configuration, that is, if you have configured any items in a stateful policy or in per-instance configs. The group might report that it has no stateful config even when there is still some preserved state on a managed instance, for example, if you have deleted all PICs but not yet applied those deletions.", + "description": "[Output Only] A bit indicating whether the managed instance group has stateful configuration, that is, if you have configured any items in a stateful policy or in per-instance configs. The group might report that it has no stateful configuration even when there is still some preserved state on a managed instance, for example, if you have deleted all PICs but not yet applied those deletions.", "type": "boolean" }, "isStateful": { - "description": "[Output Only] A bit indicating whether the managed instance group has stateful configuration, that is, if you have configured any items in a stateful policy or in per-instance configs. The group might report that it has no stateful config even when there is still some preserved state on a managed instance, for example, if you have deleted all PICs but not yet applied those deletions. This field is deprecated in favor of has_stateful_config.", + "description": "[Output Only] A bit indicating whether the managed instance group has stateful configuration, that is, if you have configured any items in a stateful policy or in per-instance configs. The group might report that it has no stateful configuration even when there is still some preserved state on a managed instance, for example, if you have deleted all PICs but not yet applied those deletions. This field is deprecated in favor of has_stateful_config.", "type": "boolean" }, "perInstanceConfigs": { "$ref": "InstanceGroupManagerStatusStatefulPerInstanceConfigs", - "description": "[Output Only] Status of per-instance configs on the instance." + "description": "[Output Only] Status of per-instance configurations on the instance." } }, "type": "object" @@ -51191,7 +51209,7 @@ "id": "InstanceGroupManagerStatusStatefulPerInstanceConfigs", "properties": { "allEffective": { - "description": "A bit indicating if all of the group's per-instance configs (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs.", + "description": "A bit indicating if all of the group's per-instance configurations (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs.", "type": "boolean" } }, @@ -51581,7 +51599,7 @@ "id": "InstanceGroupManagersPatchPerInstanceConfigsReq", "properties": { "perInstanceConfigs": { - "description": "The list of per-instance configs to insert or patch on this managed instance group.", + "description": "The list of per-instance configurations to insert or patch on this managed instance group.", "items": { "$ref": "PerInstanceConfig" }, @@ -51821,7 +51839,7 @@ "id": "InstanceGroupManagersUpdatePerInstanceConfigsReq", "properties": { "perInstanceConfigs": { - "description": "The list of per-instance configs to insert or patch on this managed instance group.", + "description": "The list of per-instance configurations to insert or patch on this managed instance group.", "items": { "$ref": "PerInstanceConfig" }, @@ -56723,7 +56741,7 @@ "properties": { "allInstancesConfig": { "$ref": "ManagedInstanceAllInstancesConfig", - "description": "[Output Only] Instances config revision applied to this instance." + "description": "[Output Only] Current all-instances configuration revision applied to this instance." }, "currentAction": { "description": "[Output Only] The current action that the managed instance group has scheduled for the instance. Possible values: - NONE The instance is running, and the managed instance group does not have any scheduled actions for this instance. - CREATING The managed instance group is creating this instance. If the group fails to create this instance, it will try again until it is successful. - CREATING_WITHOUT_RETRIES The managed instance group is attempting to create this instance only once. If the group fails to create this instance, it does not try again and the group's targetSize value is decreased instead. - RECREATING The managed instance group is recreating this instance. - DELETING The managed instance group is permanently deleting this instance. - ABANDONING The managed instance group is abandoning this instance. The instance will be removed from the instance group and from any target pools that are associated with this group. - RESTARTING The managed instance group is restarting the instance. - REFRESHING The managed instance group is applying configuration changes to the instance without stopping it. For example, the group can update the target pool list for an instance without stopping that instance. - VERIFYING The managed instance group has created the instance and it is in the process of being verified. ", @@ -56852,7 +56870,7 @@ "id": "ManagedInstanceAllInstancesConfig", "properties": { "revision": { - "description": "[Output Only] Instances config revision. This value is in RFC3339 text format.", + "description": "[Output Only] Current all-instances configuration revision. This value is in RFC3339 text format.", "type": "string" } }, @@ -62121,12 +62139,12 @@ "id": "PerInstanceConfig", "properties": { "fingerprint": { - "description": "Fingerprint of this per-instance config. This field can be used in optimistic locking. It is ignored when inserting a per-instance config. An up-to-date fingerprint must be provided in order to update an existing per-instance config or the field needs to be unset.", + "description": "Fingerprint of this per-instance config. This field can be used in optimistic locking. It is ignored when inserting a per-instance config. An up-to-date fingerprint must be provided in order to update an existing per-instance configuration or the field needs to be unset.", "format": "byte", "type": "string" }, "name": { - "description": "The name of a per-instance config and its corresponding instance. Serves as a merge key during UpdatePerInstanceConfigs operations, that is, if a per-instance config with the same name exists then it will be updated, otherwise a new one will be created for the VM instance with the same name. An attempt to create a per-instance config for a VM instance that either doesn't exist or is not part of the group will result in an error.", + "description": "The name of a per-instance configuration and its corresponding instance. Serves as a merge key during UpdatePerInstanceConfigs operations, that is, if a per-instance configuration with the same name exists then it will be updated, otherwise a new one will be created for the VM instance with the same name. An attempt to create a per-instance configconfiguration for a VM instance that either doesn't exist or is not part of the group will result in an error.", "type": "string" }, "preservedState": { @@ -62134,7 +62152,7 @@ "description": "The intended preserved state for the given instance. Does not contain preserved state generated from a stateful policy." }, "status": { - "description": "The status of applying this per-instance config on the corresponding managed instance.", + "description": "The status of applying this per-instance configuration on the corresponding managed instance.", "enum": [ "APPLYING", "DELETING", @@ -62144,12 +62162,12 @@ "UNAPPLIED_DELETION" ], "enumDescriptions": [ - "The per-instance config is being applied to the instance, but is not yet effective, possibly waiting for the instance to, for example, REFRESH.", - "The per-instance config deletion is being applied on the instance, possibly waiting for the instance to, for example, REFRESH.", - "The per-instance config is effective on the instance, meaning that all disks, ips and metadata specified in this config are attached or set on the instance.", - "*[Default]* The default status, when no per-instance config exists.", - "The per-instance config is set on an instance but not been applied yet.", - "The per-instance config has been deleted, but the deletion is not yet applied." + "The per-instance configuration is being applied to the instance, but is not yet effective, possibly waiting for the instance to, for example, REFRESH.", + "The per-instance configuration deletion is being applied on the instance, possibly waiting for the instance to, for example, REFRESH.", + "The per-instance configuration is effective on the instance, meaning that all disks, ips and metadata specified in this configuration are attached or set on the instance.", + "*[Default]* The default status, when no per-instance configuration exists.", + "The per-instance configuration is set on an instance but not been applied yet.", + "The per-instance configuration has been deleted, but the deletion is not yet applied." ], "type": "string" } @@ -64358,7 +64376,7 @@ "id": "RegionInstanceGroupManagerPatchInstanceConfigReq", "properties": { "perInstanceConfigs": { - "description": "The list of per-instance configs to insert or patch on this managed instance group.", + "description": "The list of per-instance configurations to insert or patch on this managed instance group.", "items": { "$ref": "PerInstanceConfig" }, @@ -64372,7 +64390,7 @@ "id": "RegionInstanceGroupManagerUpdateInstanceConfigReq", "properties": { "perInstanceConfigs": { - "description": "The list of per-instance configs to insert or patch on this managed instance group.", + "description": "The list of per-instance configurations to insert or patch on this managed instance group.", "items": { "$ref": "PerInstanceConfig" }, diff --git a/compute/v0.alpha/compute-gen.go b/compute/v0.alpha/compute-gen.go index 8532e6493c3..b49c248ab01 100644 --- a/compute/v0.alpha/compute-gen.go +++ b/compute/v0.alpha/compute-gen.go @@ -7462,8 +7462,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 @@ -8693,12 +8693,23 @@ func (s *Condition) MarshalJSON() ([]byte, error) { // ConfidentialInstanceConfig: A set of Confidential Instance options. type ConfidentialInstanceConfig struct { + // ConfidentialInstanceType: Defines the type of technology used by the + // confidential instance. + // + // Possible values: + // "CONFIDENTIAL_INSTANCE_TYPE_UNSPECIFIED" - No type specified. Do + // not use this value. + // "SEV" - AMD Secure Encrypted Virtualization. + // "SEV_SNP" - AMD Secure Encrypted Virtualization - Secure Nested + // Paging. + ConfidentialInstanceType string `json:"confidentialInstanceType,omitempty"` + // EnableConfidentialCompute: Defines whether the instance should have // confidential compute enabled. EnableConfidentialCompute bool `json:"enableConfidentialCompute,omitempty"` // ForceSendFields is a list of field names (e.g. - // "EnableConfidentialCompute") to unconditionally include in API + // "ConfidentialInstanceType") 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 @@ -8706,13 +8717,13 @@ type ConfidentialInstanceConfig struct { // fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. - // "EnableConfidentialCompute") 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 is a list of field names (e.g. "ConfidentialInstanceType") + // 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:"-"` } @@ -10036,6 +10047,8 @@ func (s *DiskResourceStatus) MarshalJSON() ([]byte, error) { type DiskResourceStatusAsyncReplicationStatus struct { // Possible values: // "ACTIVE" - Replication is active. + // "CREATED" - Secondary disk is created and is waiting for + // replication to start. // "STARTING" - Replication is starting. // "STATE_UNSPECIFIED" // "STOPPED" - Replication is stopped. @@ -15141,6 +15154,7 @@ type GuestOsFeature struct { // "MULTI_IP_SUBNET" // "SECURE_BOOT" // "SEV_CAPABLE" + // "SEV_SNP_CAPABLE" // "UEFI_COMPATIBLE" // "VIRTIO_SCSI_MULTIQUEUE" // "WINDOWS" @@ -20063,8 +20077,8 @@ func (s *InstanceGroupListWarningData) MarshalJSON() ([]byte, error) { // For regional Managed Instance Group, use the // regionInstanceGroupManagers resource. type InstanceGroupManager struct { - // AllInstancesConfig: Specifies the instances configs overrides that - // should be applied for all instances in the MIG. + // AllInstancesConfig: Specifies configuration that overrides the + // instance template configuration for the group. AllInstancesConfig *InstanceGroupManagerAllInstancesConfig `json:"allInstancesConfig,omitempty"` // AutoHealingPolicies: The autohealing policy for this managed instance @@ -20537,11 +20551,13 @@ func (s *InstanceGroupManagerAggregatedListWarningData) MarshalJSON() ([]byte, e } type InstanceGroupManagerAllInstancesConfig struct { - // Properties: Properties for instances that are created using this - // instances config. You can add or modify properties using the - // instanceGroupManagers.patch or regionInstanceGroupManagers.patch. - // After setting instances_config, you must update your instances to use - // it; for example, you can use the applyUpdatesToInstances method. + // Properties: Properties to set on all instances in the group. You can + // add or modify properties using the instanceGroupManagers.patch or + // regionInstanceGroupManagers.patch. After setting allInstancesConfig + // on the group, you must update the group's instances to apply the + // configuration. To apply the configuration, set the group's + // updatePolicy.type field to use proactive updates or use the + // applyUpdatesToInstances method. Properties *InstancePropertiesPatch `json:"properties,omitempty"` // ForceSendFields is a list of field names (e.g. "Properties") to @@ -20955,9 +20971,8 @@ func (s *InstanceGroupManagerStandbyPolicy) MarshalJSON() ([]byte, error) { } type InstanceGroupManagerStatus struct { - // AllInstancesConfig: [Output Only] A status of consistency of - // Instances' config applied to instances with Instances' config defined - // in managed instance group. + // AllInstancesConfig: [Output only] Status of all-instances + // configuration on the group. AllInstancesConfig *InstanceGroupManagerStatusAllInstancesConfig `json:"allInstancesConfig,omitempty"` // Autoscaler: [Output Only] The URL of the Autoscaler that targets this @@ -21006,12 +21021,12 @@ func (s *InstanceGroupManagerStatus) MarshalJSON() ([]byte, error) { } type InstanceGroupManagerStatusAllInstancesConfig struct { - // CurrentRevision: [Output Only] Current instances' config revision. - // This value is in RFC3339 text format. + // CurrentRevision: [Output Only] Current all-instances configuration + // revision. This value is in RFC3339 text format. CurrentRevision string `json:"currentRevision,omitempty"` - // Effective: [Output Only] A bit indicating whether instances' config - // has been applied to all managed instances in managed instance group. + // Effective: [Output Only] A bit indicating whether this configuration + // has been applied to all managed instances in the group. Effective bool `json:"effective,omitempty"` // ForceSendFields is a list of field names (e.g. "CurrentRevision") to @@ -21042,22 +21057,23 @@ type InstanceGroupManagerStatusStateful struct { // HasStatefulConfig: [Output Only] A bit indicating whether the managed // instance group has stateful configuration, that is, if you have // configured any items in a stateful policy or in per-instance configs. - // The group might report that it has no stateful config even when there - // is still some preserved state on a managed instance, for example, if - // you have deleted all PICs but not yet applied those deletions. + // The group might report that it has no stateful configuration even + // when there is still some preserved state on a managed instance, for + // example, if you have deleted all PICs but not yet applied those + // deletions. HasStatefulConfig bool `json:"hasStatefulConfig,omitempty"` // IsStateful: [Output Only] A bit indicating whether the managed // instance group has stateful configuration, that is, if you have // configured any items in a stateful policy or in per-instance configs. - // The group might report that it has no stateful config even when there - // is still some preserved state on a managed instance, for example, if - // you have deleted all PICs but not yet applied those deletions. This - // field is deprecated in favor of has_stateful_config. + // The group might report that it has no stateful configuration even + // when there is still some preserved state on a managed instance, for + // example, if you have deleted all PICs but not yet applied those + // deletions. This field is deprecated in favor of has_stateful_config. IsStateful bool `json:"isStateful,omitempty"` - // PerInstanceConfigs: [Output Only] Status of per-instance configs on - // the instance. + // PerInstanceConfigs: [Output Only] Status of per-instance + // configurations on the instance. PerInstanceConfigs *InstanceGroupManagerStatusStatefulPerInstanceConfigs `json:"perInstanceConfigs,omitempty"` // ForceSendFields is a list of field names (e.g. "HasStatefulConfig") @@ -21086,8 +21102,8 @@ func (s *InstanceGroupManagerStatusStateful) MarshalJSON() ([]byte, error) { type InstanceGroupManagerStatusStatefulPerInstanceConfigs struct { // AllEffective: A bit indicating if all of the group's per-instance - // configs (listed in the output of a listPerInstanceConfigs API call) - // have status EFFECTIVE or there are no per-instance-configs. + // configurations (listed in the output of a listPerInstanceConfigs API + // call) have status EFFECTIVE or there are no per-instance-configs. AllEffective bool `json:"allEffective,omitempty"` // ForceSendFields is a list of field names (e.g. "AllEffective") to @@ -21795,8 +21811,8 @@ func (s *InstanceGroupManagersListPerInstanceConfigsRespWarningData) MarshalJSON // InstanceGroupManagersPatchPerInstanceConfigsReq: // InstanceGroupManagers.patchPerInstanceConfigs type InstanceGroupManagersPatchPerInstanceConfigsReq struct { - // PerInstanceConfigs: The list of per-instance configs to insert or - // patch on this managed instance group. + // PerInstanceConfigs: The list of per-instance configurations to insert + // or patch on this managed instance group. PerInstanceConfigs []*PerInstanceConfig `json:"perInstanceConfigs,omitempty"` // ForceSendFields is a list of field names (e.g. "PerInstanceConfigs") @@ -22293,8 +22309,8 @@ func (s *InstanceGroupManagersSuspendInstancesRequest) MarshalJSON() ([]byte, er // InstanceGroupManagersUpdatePerInstanceConfigsReq: // InstanceGroupManagers.updatePerInstanceConfigs type InstanceGroupManagersUpdatePerInstanceConfigsReq struct { - // PerInstanceConfigs: The list of per-instance configs to insert or - // patch on this managed instance group. + // PerInstanceConfigs: The list of per-instance configurations to insert + // or patch on this managed instance group. PerInstanceConfigs []*PerInstanceConfig `json:"perInstanceConfigs,omitempty"` // ForceSendFields is a list of field names (e.g. "PerInstanceConfigs") @@ -29973,8 +29989,8 @@ func (s *MachineTypesScopedListWarningData) MarshalJSON() ([]byte, error) { // ManagedInstance: A Managed Instance resource. type ManagedInstance struct { - // AllInstancesConfig: [Output Only] Instances config revision applied - // to this instance. + // AllInstancesConfig: [Output Only] Current all-instances configuration + // revision applied to this instance. AllInstancesConfig *ManagedInstanceAllInstancesConfig `json:"allInstancesConfig,omitempty"` // CurrentAction: [Output Only] The current action that the managed @@ -30133,8 +30149,8 @@ func (s *ManagedInstance) MarshalJSON() ([]byte, error) { } type ManagedInstanceAllInstancesConfig struct { - // Revision: [Output Only] Instances config revision. This value is in - // RFC3339 text format. + // Revision: [Output Only] Current all-instances configuration revision. + // This value is in RFC3339 text format. Revision string `json:"revision,omitempty"` // ForceSendFields is a list of field names (e.g. "Revision") to @@ -38473,42 +38489,42 @@ type PerInstanceConfig struct { // Fingerprint: Fingerprint of this per-instance config. This field can // be used in optimistic locking. It is ignored when inserting a // per-instance config. An up-to-date fingerprint must be provided in - // order to update an existing per-instance config or the field needs to - // be unset. + // order to update an existing per-instance configuration or the field + // needs to be unset. Fingerprint string `json:"fingerprint,omitempty"` - // Name: The name of a per-instance config and its corresponding + // Name: The name of a per-instance configuration and its corresponding // instance. Serves as a merge key during UpdatePerInstanceConfigs - // operations, that is, if a per-instance config with the same name - // exists then it will be updated, otherwise a new one will be created - // for the VM instance with the same name. An attempt to create a - // per-instance config for a VM instance that either doesn't exist or is - // not part of the group will result in an error. + // operations, that is, if a per-instance configuration with the same + // name exists then it will be updated, otherwise a new one will be + // created for the VM instance with the same name. An attempt to create + // a per-instance configconfiguration for a VM instance that either + // doesn't exist or is not part of the group will result in an error. Name string `json:"name,omitempty"` // PreservedState: The intended preserved state for the given instance. // Does not contain preserved state generated from a stateful policy. PreservedState *PreservedState `json:"preservedState,omitempty"` - // Status: The status of applying this per-instance config on the + // Status: The status of applying this per-instance configuration on the // corresponding managed instance. // // Possible values: - // "APPLYING" - The per-instance config is being applied to the + // "APPLYING" - The per-instance configuration is being applied to the // instance, but is not yet effective, possibly waiting for the instance // to, for example, REFRESH. - // "DELETING" - The per-instance config deletion is being applied on - // the instance, possibly waiting for the instance to, for example, - // REFRESH. - // "EFFECTIVE" - The per-instance config is effective on the instance, - // meaning that all disks, ips and metadata specified in this config are - // attached or set on the instance. + // "DELETING" - The per-instance configuration deletion is being + // applied on the instance, possibly waiting for the instance to, for + // example, REFRESH. + // "EFFECTIVE" - The per-instance configuration is effective on the + // instance, meaning that all disks, ips and metadata specified in this + // configuration are attached or set on the instance. // "NONE" - *[Default]* The default status, when no per-instance - // config exists. - // "UNAPPLIED" - The per-instance config is set on an instance but not - // been applied yet. - // "UNAPPLIED_DELETION" - The per-instance config has been deleted, - // but the deletion is not yet applied. + // configuration exists. + // "UNAPPLIED" - The per-instance configuration is set on an instance + // but not been applied yet. + // "UNAPPLIED_DELETION" - The per-instance configuration has been + // deleted, but the deletion is not yet applied. Status string `json:"status,omitempty"` // ForceSendFields is a list of field names (e.g. "Fingerprint") to @@ -41691,8 +41707,8 @@ func (s *RegionInstanceGroupManagerListWarningData) MarshalJSON() ([]byte, error // RegionInstanceGroupManagerPatchInstanceConfigReq: // RegionInstanceGroupManagers.patchPerInstanceConfigs type RegionInstanceGroupManagerPatchInstanceConfigReq struct { - // PerInstanceConfigs: The list of per-instance configs to insert or - // patch on this managed instance group. + // PerInstanceConfigs: The list of per-instance configurations to insert + // or patch on this managed instance group. PerInstanceConfigs []*PerInstanceConfig `json:"perInstanceConfigs,omitempty"` // ForceSendFields is a list of field names (e.g. "PerInstanceConfigs") @@ -41722,8 +41738,8 @@ func (s *RegionInstanceGroupManagerPatchInstanceConfigReq) MarshalJSON() ([]byte // RegionInstanceGroupManagerUpdateInstanceConfigReq: // RegionInstanceGroupManagers.updatePerInstanceConfigs type RegionInstanceGroupManagerUpdateInstanceConfigReq struct { - // PerInstanceConfigs: The list of per-instance configs to insert or - // patch on this managed instance group. + // PerInstanceConfigs: The list of per-instance configurations to insert + // or patch on this managed instance group. PerInstanceConfigs []*PerInstanceConfig `json:"perInstanceConfigs,omitempty"` // ForceSendFields is a list of field names (e.g. "PerInstanceConfigs") @@ -98474,12 +98490,12 @@ type InstanceGroupManagersCreateInstancesCall struct { header_ http.Header } -// CreateInstances: Creates instances with per-instance configs in this -// managed instance group. Instances are created using the current -// instance template. The create instances operation is marked DONE if -// the createInstances request is successful. The underlying actions -// take additional time. You must separately verify the status of the -// creating or actions with the listmanagedinstances method. +// CreateInstances: Creates instances with per-instance configurations +// in this managed instance group. Instances are created using the +// current instance template. The create instances operation is marked +// DONE if the createInstances request is successful. The underlying +// actions take additional time. You must separately verify the status +// of the creating or actions with the listmanagedinstances method. // // - instanceGroupManager: The name of the managed instance group. It // should conform to RFC1035. @@ -98603,7 +98619,7 @@ func (c *InstanceGroupManagersCreateInstancesCall) Do(opts ...googleapi.CallOpti } return ret, nil // { - // "description": "Creates instances with per-instance configs in this managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method.", + // "description": "Creates instances with per-instance configurations in this managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method.", // "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/createInstances", // "httpMethod": "POST", // "id": "compute.instanceGroupManagers.createInstances", @@ -99045,8 +99061,8 @@ type InstanceGroupManagersDeletePerInstanceConfigsCall struct { header_ http.Header } -// DeletePerInstanceConfigs: Deletes selected per-instance configs for -// the managed instance group. +// DeletePerInstanceConfigs: Deletes selected per-instance +// configurations for the managed instance group. // // - instanceGroupManager: The name of the managed instance group. It // should conform to RFC1035. @@ -99155,7 +99171,7 @@ func (c *InstanceGroupManagersDeletePerInstanceConfigsCall) Do(opts ...googleapi } return ret, nil // { - // "description": "Deletes selected per-instance configs for the managed instance group.", + // "description": "Deletes selected per-instance configurations for the managed instance group.", // "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", // "httpMethod": "POST", // "id": "compute.instanceGroupManagers.deletePerInstanceConfigs", @@ -100426,9 +100442,9 @@ type InstanceGroupManagersListPerInstanceConfigsCall struct { header_ http.Header } -// ListPerInstanceConfigs: Lists all of the per-instance configs defined -// for the managed instance group. The orderBy query parameter is not -// supported. +// ListPerInstanceConfigs: Lists all of the per-instance configurations +// defined for the managed instance group. The orderBy query parameter +// is not supported. // // - instanceGroupManager: The name of the managed instance group. It // should conform to RFC1035. @@ -100602,7 +100618,7 @@ func (c *InstanceGroupManagersListPerInstanceConfigsCall) Do(opts ...googleapi.C } return ret, nil // { - // "description": "Lists all of the per-instance configs defined for the managed instance group. The orderBy query parameter is not supported.", + // "description": "Lists all of the per-instance configurations defined for the managed instance group. The orderBy query parameter is not supported.", // "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", // "httpMethod": "POST", // "id": "compute.instanceGroupManagers.listPerInstanceConfigs", @@ -100904,9 +100920,10 @@ type InstanceGroupManagersPatchPerInstanceConfigsCall struct { header_ http.Header } -// PatchPerInstanceConfigs: Inserts or patches per-instance configs for -// the managed instance group. perInstanceConfig.name serves as a key -// used to distinguish whether to perform insert or patch. +// PatchPerInstanceConfigs: Inserts or patches per-instance +// configurations for the managed instance group. perInstanceConfig.name +// serves as a key used to distinguish whether to perform insert or +// patch. // // - instanceGroupManager: The name of the managed instance group. It // should conform to RFC1035. @@ -101031,7 +101048,7 @@ func (c *InstanceGroupManagersPatchPerInstanceConfigsCall) Do(opts ...googleapi. } return ret, nil // { - // "description": "Inserts or patches per-instance configs for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", + // "description": "Inserts or patches per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", // "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", // "httpMethod": "POST", // "id": "compute.instanceGroupManagers.patchPerInstanceConfigs", @@ -103445,9 +103462,10 @@ type InstanceGroupManagersUpdatePerInstanceConfigsCall struct { header_ http.Header } -// UpdatePerInstanceConfigs: Inserts or updates per-instance configs for -// the managed instance group. perInstanceConfig.name serves as a key -// used to distinguish whether to perform insert or patch. +// UpdatePerInstanceConfigs: Inserts or updates per-instance +// configurations for the managed instance group. perInstanceConfig.name +// serves as a key used to distinguish whether to perform insert or +// patch. // // - instanceGroupManager: The name of the managed instance group. It // should conform to RFC1035. @@ -103572,7 +103590,7 @@ func (c *InstanceGroupManagersUpdatePerInstanceConfigsCall) Do(opts ...googleapi } return ret, nil // { - // "description": "Inserts or updates per-instance configs for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", + // "description": "Inserts or updates per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", // "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", // "httpMethod": "POST", // "id": "compute.instanceGroupManagers.updatePerInstanceConfigs", @@ -161763,12 +161781,13 @@ type RegionInstanceGroupManagersCreateInstancesCall struct { header_ http.Header } -// CreateInstances: Creates instances with per-instance configs in this -// regional managed instance group. Instances are created using the -// current instance template. The create instances operation is marked -// DONE if the createInstances request is successful. The underlying -// actions take additional time. You must separately verify the status -// of the creating or actions with the listmanagedinstances method. +// CreateInstances: Creates instances with per-instance configurations +// in this regional managed instance group. Instances are created using +// the current instance template. The create instances operation is +// marked DONE if the createInstances request is successful. The +// underlying actions take additional time. You must separately verify +// the status of the creating or actions with the listmanagedinstances +// method. // // - instanceGroupManager: The name of the managed instance group. It // should conform to RFC1035. @@ -161892,7 +161911,7 @@ func (c *RegionInstanceGroupManagersCreateInstancesCall) Do(opts ...googleapi.Ca } return ret, nil // { - // "description": "Creates instances with per-instance configs in this regional managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method.", + // "description": "Creates instances with per-instance configurations in this regional managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method.", // "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/createInstances", // "httpMethod": "POST", // "id": "compute.regionInstanceGroupManagers.createInstances", @@ -162330,8 +162349,8 @@ type RegionInstanceGroupManagersDeletePerInstanceConfigsCall struct { header_ http.Header } -// DeletePerInstanceConfigs: Deletes selected per-instance configs for -// the managed instance group. +// DeletePerInstanceConfigs: Deletes selected per-instance +// configurations for the managed instance group. // // - instanceGroupManager: The name of the managed instance group. It // should conform to RFC1035. @@ -162440,7 +162459,7 @@ func (c *RegionInstanceGroupManagersDeletePerInstanceConfigsCall) Do(opts ...goo } return ret, nil // { - // "description": "Deletes selected per-instance configs for the managed instance group.", + // "description": "Deletes selected per-instance configurations for the managed instance group.", // "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", // "httpMethod": "POST", // "id": "compute.regionInstanceGroupManagers.deletePerInstanceConfigs", @@ -163703,9 +163722,9 @@ type RegionInstanceGroupManagersListPerInstanceConfigsCall struct { header_ http.Header } -// ListPerInstanceConfigs: Lists all of the per-instance configs defined -// for the managed instance group. The orderBy query parameter is not -// supported. +// ListPerInstanceConfigs: Lists all of the per-instance configurations +// defined for the managed instance group. The orderBy query parameter +// is not supported. // // - instanceGroupManager: The name of the managed instance group. It // should conform to RFC1035. @@ -163879,7 +163898,7 @@ func (c *RegionInstanceGroupManagersListPerInstanceConfigsCall) Do(opts ...googl } return ret, nil // { - // "description": "Lists all of the per-instance configs defined for the managed instance group. The orderBy query parameter is not supported.", + // "description": "Lists all of the per-instance configurations defined for the managed instance group. The orderBy query parameter is not supported.", // "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", // "httpMethod": "POST", // "id": "compute.regionInstanceGroupManagers.listPerInstanceConfigs", @@ -164180,9 +164199,10 @@ type RegionInstanceGroupManagersPatchPerInstanceConfigsCall struct { header_ http.Header } -// PatchPerInstanceConfigs: Inserts or patches per-instance configs for -// the managed instance group. perInstanceConfig.name serves as a key -// used to distinguish whether to perform insert or patch. +// PatchPerInstanceConfigs: Inserts or patches per-instance +// configurations for the managed instance group. perInstanceConfig.name +// serves as a key used to distinguish whether to perform insert or +// patch. // // - instanceGroupManager: The name of the managed instance group. It // should conform to RFC1035. @@ -164307,7 +164327,7 @@ func (c *RegionInstanceGroupManagersPatchPerInstanceConfigsCall) Do(opts ...goog } return ret, nil // { - // "description": "Inserts or patches per-instance configs for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", + // "description": "Inserts or patches per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", // "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", // "httpMethod": "POST", // "id": "compute.regionInstanceGroupManagers.patchPerInstanceConfigs", @@ -166698,9 +166718,10 @@ type RegionInstanceGroupManagersUpdatePerInstanceConfigsCall struct { header_ http.Header } -// UpdatePerInstanceConfigs: Inserts or updates per-instance configs for -// the managed instance group. perInstanceConfig.name serves as a key -// used to distinguish whether to perform insert or patch. +// UpdatePerInstanceConfigs: Inserts or updates per-instance +// configurations for the managed instance group. perInstanceConfig.name +// serves as a key used to distinguish whether to perform insert or +// patch. // // - instanceGroupManager: The name of the managed instance group. It // should conform to RFC1035. @@ -166825,7 +166846,7 @@ func (c *RegionInstanceGroupManagersUpdatePerInstanceConfigsCall) Do(opts ...goo } return ret, nil // { - // "description": "Inserts or updates per-instance configs for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", + // "description": "Inserts or updates per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", // "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", // "httpMethod": "POST", // "id": "compute.regionInstanceGroupManagers.updatePerInstanceConfigs", diff --git a/compute/v1/compute-api.json b/compute/v1/compute-api.json index a69d8a8c76c..984dd60492b 100644 --- a/compute/v1/compute-api.json +++ b/compute/v1/compute-api.json @@ -6911,7 +6911,7 @@ ] }, "createInstances": { - "description": "Creates instances with per-instance configs in this managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method.", + "description": "Creates instances with per-instance configurations in this managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method.", "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/createInstances", "httpMethod": "POST", "id": "compute.instanceGroupManagers.createInstances", @@ -7052,7 +7052,7 @@ ] }, "deletePerInstanceConfigs": { - "description": "Deletes selected per-instance configs for the managed instance group.", + "description": "Deletes selected per-instance configurations for the managed instance group.", "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", "httpMethod": "POST", "id": "compute.instanceGroupManagers.deletePerInstanceConfigs", @@ -7377,7 +7377,7 @@ ] }, "listPerInstanceConfigs": { - "description": "Lists all of the per-instance configs defined for the managed instance group. The orderBy query parameter is not supported.", + "description": "Lists all of the per-instance configurations defined for the managed instance group. The orderBy query parameter is not supported.", "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", "httpMethod": "POST", "id": "compute.instanceGroupManagers.listPerInstanceConfigs", @@ -7494,7 +7494,7 @@ ] }, "patchPerInstanceConfigs": { - "description": "Inserts or patches per-instance configs for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", + "description": "Inserts or patches per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", "httpMethod": "POST", "id": "compute.instanceGroupManagers.patchPerInstanceConfigs", @@ -7739,7 +7739,7 @@ ] }, "updatePerInstanceConfigs": { - "description": "Inserts or updates per-instance configs for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", + "description": "Inserts or updates per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", "httpMethod": "POST", "id": "compute.instanceGroupManagers.updatePerInstanceConfigs", @@ -19095,7 +19095,7 @@ ] }, "createInstances": { - "description": "Creates instances with per-instance configs in this regional managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method.", + "description": "Creates instances with per-instance configurations in this regional managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method.", "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/createInstances", "httpMethod": "POST", "id": "compute.regionInstanceGroupManagers.createInstances", @@ -19236,7 +19236,7 @@ ] }, "deletePerInstanceConfigs": { - "description": "Deletes selected per-instance configs for the managed instance group.", + "description": "Deletes selected per-instance configurations for the managed instance group.", "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", "httpMethod": "POST", "id": "compute.regionInstanceGroupManagers.deletePerInstanceConfigs", @@ -19561,7 +19561,7 @@ ] }, "listPerInstanceConfigs": { - "description": "Lists all of the per-instance configs defined for the managed instance group. The orderBy query parameter is not supported.", + "description": "Lists all of the per-instance configurations defined for the managed instance group. The orderBy query parameter is not supported.", "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", "httpMethod": "POST", "id": "compute.regionInstanceGroupManagers.listPerInstanceConfigs", @@ -19678,7 +19678,7 @@ ] }, "patchPerInstanceConfigs": { - "description": "Inserts or patches per-instance configs for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", + "description": "Inserts or patches per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", "httpMethod": "POST", "id": "compute.regionInstanceGroupManagers.patchPerInstanceConfigs", @@ -19924,7 +19924,7 @@ ] }, "updatePerInstanceConfigs": { - "description": "Inserts or updates per-instance configs for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", + "description": "Inserts or updates per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", "httpMethod": "POST", "id": "compute.regionInstanceGroupManagers.updatePerInstanceConfigs", @@ -31075,7 +31075,7 @@ } } }, - "revision": "20220322", + "revision": "20220405", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -34602,7 +34602,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" }, @@ -41682,12 +41682,12 @@ "id": "InstanceGroupManagerStatusStateful", "properties": { "hasStatefulConfig": { - "description": "[Output Only] A bit indicating whether the managed instance group has stateful configuration, that is, if you have configured any items in a stateful policy or in per-instance configs. The group might report that it has no stateful config even when there is still some preserved state on a managed instance, for example, if you have deleted all PICs but not yet applied those deletions.", + "description": "[Output Only] A bit indicating whether the managed instance group has stateful configuration, that is, if you have configured any items in a stateful policy or in per-instance configs. The group might report that it has no stateful configuration even when there is still some preserved state on a managed instance, for example, if you have deleted all PICs but not yet applied those deletions.", "type": "boolean" }, "perInstanceConfigs": { "$ref": "InstanceGroupManagerStatusStatefulPerInstanceConfigs", - "description": "[Output Only] Status of per-instance configs on the instance." + "description": "[Output Only] Status of per-instance configurations on the instance." } }, "type": "object" @@ -41696,7 +41696,7 @@ "id": "InstanceGroupManagerStatusStatefulPerInstanceConfigs", "properties": { "allEffective": { - "description": "A bit indicating if all of the group's per-instance configs (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs.", + "description": "A bit indicating if all of the group's per-instance configurations (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs.", "type": "boolean" } }, @@ -42061,7 +42061,7 @@ "id": "InstanceGroupManagersPatchPerInstanceConfigsReq", "properties": { "perInstanceConfigs": { - "description": "The list of per-instance configs to insert or patch on this managed instance group.", + "description": "The list of per-instance configurations to insert or patch on this managed instance group.", "items": { "$ref": "PerInstanceConfig" }, @@ -42214,7 +42214,7 @@ "id": "InstanceGroupManagersUpdatePerInstanceConfigsReq", "properties": { "perInstanceConfigs": { - "description": "The list of per-instance configs to insert or patch on this managed instance group.", + "description": "The list of per-instance configurations to insert or patch on this managed instance group.", "items": { "$ref": "PerInstanceConfig" }, @@ -50752,12 +50752,12 @@ "id": "PerInstanceConfig", "properties": { "fingerprint": { - "description": "Fingerprint of this per-instance config. This field can be used in optimistic locking. It is ignored when inserting a per-instance config. An up-to-date fingerprint must be provided in order to update an existing per-instance config or the field needs to be unset.", + "description": "Fingerprint of this per-instance config. This field can be used in optimistic locking. It is ignored when inserting a per-instance config. An up-to-date fingerprint must be provided in order to update an existing per-instance configuration or the field needs to be unset.", "format": "byte", "type": "string" }, "name": { - "description": "The name of a per-instance config and its corresponding instance. Serves as a merge key during UpdatePerInstanceConfigs operations, that is, if a per-instance config with the same name exists then it will be updated, otherwise a new one will be created for the VM instance with the same name. An attempt to create a per-instance config for a VM instance that either doesn't exist or is not part of the group will result in an error.", + "description": "The name of a per-instance configuration and its corresponding instance. Serves as a merge key during UpdatePerInstanceConfigs operations, that is, if a per-instance configuration with the same name exists then it will be updated, otherwise a new one will be created for the VM instance with the same name. An attempt to create a per-instance configconfiguration for a VM instance that either doesn't exist or is not part of the group will result in an error.", "type": "string" }, "preservedState": { @@ -50765,7 +50765,7 @@ "description": "The intended preserved state for the given instance. Does not contain preserved state generated from a stateful policy." }, "status": { - "description": "The status of applying this per-instance config on the corresponding managed instance.", + "description": "The status of applying this per-instance configuration on the corresponding managed instance.", "enum": [ "APPLYING", "DELETING", @@ -50775,12 +50775,12 @@ "UNAPPLIED_DELETION" ], "enumDescriptions": [ - "The per-instance config is being applied to the instance, but is not yet effective, possibly waiting for the instance to, for example, REFRESH.", - "The per-instance config deletion is being applied on the instance, possibly waiting for the instance to, for example, REFRESH.", - "The per-instance config is effective on the instance, meaning that all disks, ips and metadata specified in this config are attached or set on the instance.", - "*[Default]* The default status, when no per-instance config exists.", - "The per-instance config is set on an instance but not been applied yet.", - "The per-instance config has been deleted, but the deletion is not yet applied." + "The per-instance configuration is being applied to the instance, but is not yet effective, possibly waiting for the instance to, for example, REFRESH.", + "The per-instance configuration deletion is being applied on the instance, possibly waiting for the instance to, for example, REFRESH.", + "The per-instance configuration is effective on the instance, meaning that all disks, ips and metadata specified in this configuration are attached or set on the instance.", + "*[Default]* The default status, when no per-instance configuration exists.", + "The per-instance configuration is set on an instance but not been applied yet.", + "The per-instance configuration has been deleted, but the deletion is not yet applied." ], "type": "string" } @@ -52640,7 +52640,7 @@ "id": "RegionInstanceGroupManagerPatchInstanceConfigReq", "properties": { "perInstanceConfigs": { - "description": "The list of per-instance configs to insert or patch on this managed instance group.", + "description": "The list of per-instance configurations to insert or patch on this managed instance group.", "items": { "$ref": "PerInstanceConfig" }, @@ -52654,7 +52654,7 @@ "id": "RegionInstanceGroupManagerUpdateInstanceConfigReq", "properties": { "perInstanceConfigs": { - "description": "The list of per-instance configs to insert or patch on this managed instance group.", + "description": "The list of per-instance configurations to insert or patch on this managed instance group.", "items": { "$ref": "PerInstanceConfig" }, diff --git a/compute/v1/compute-gen.go b/compute/v1/compute-gen.go index ad39992599d..63cece78188 100644 --- a/compute/v1/compute-gen.go +++ b/compute/v1/compute-gen.go @@ -6952,8 +6952,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 @@ -18118,13 +18118,14 @@ type InstanceGroupManagerStatusStateful struct { // HasStatefulConfig: [Output Only] A bit indicating whether the managed // instance group has stateful configuration, that is, if you have // configured any items in a stateful policy or in per-instance configs. - // The group might report that it has no stateful config even when there - // is still some preserved state on a managed instance, for example, if - // you have deleted all PICs but not yet applied those deletions. + // The group might report that it has no stateful configuration even + // when there is still some preserved state on a managed instance, for + // example, if you have deleted all PICs but not yet applied those + // deletions. HasStatefulConfig bool `json:"hasStatefulConfig,omitempty"` - // PerInstanceConfigs: [Output Only] Status of per-instance configs on - // the instance. + // PerInstanceConfigs: [Output Only] Status of per-instance + // configurations on the instance. PerInstanceConfigs *InstanceGroupManagerStatusStatefulPerInstanceConfigs `json:"perInstanceConfigs,omitempty"` // ForceSendFields is a list of field names (e.g. "HasStatefulConfig") @@ -18153,8 +18154,8 @@ func (s *InstanceGroupManagerStatusStateful) MarshalJSON() ([]byte, error) { type InstanceGroupManagerStatusStatefulPerInstanceConfigs struct { // AllEffective: A bit indicating if all of the group's per-instance - // configs (listed in the output of a listPerInstanceConfigs API call) - // have status EFFECTIVE or there are no per-instance-configs. + // configurations (listed in the output of a listPerInstanceConfigs API + // call) have status EFFECTIVE or there are no per-instance-configs. AllEffective bool `json:"allEffective,omitempty"` // ForceSendFields is a list of field names (e.g. "AllEffective") to @@ -18839,8 +18840,8 @@ func (s *InstanceGroupManagersListPerInstanceConfigsRespWarningData) MarshalJSON // InstanceGroupManagersPatchPerInstanceConfigsReq: // InstanceGroupManagers.patchPerInstanceConfigs type InstanceGroupManagersPatchPerInstanceConfigsReq struct { - // PerInstanceConfigs: The list of per-instance configs to insert or - // patch on this managed instance group. + // PerInstanceConfigs: The list of per-instance configurations to insert + // or patch on this managed instance group. PerInstanceConfigs []*PerInstanceConfig `json:"perInstanceConfigs,omitempty"` // ForceSendFields is a list of field names (e.g. "PerInstanceConfigs") @@ -19136,8 +19137,8 @@ func (s *InstanceGroupManagersSetTargetPoolsRequest) MarshalJSON() ([]byte, erro // InstanceGroupManagersUpdatePerInstanceConfigsReq: // InstanceGroupManagers.updatePerInstanceConfigs type InstanceGroupManagersUpdatePerInstanceConfigsReq struct { - // PerInstanceConfigs: The list of per-instance configs to insert or - // patch on this managed instance group. + // PerInstanceConfigs: The list of per-instance configurations to insert + // or patch on this managed instance group. PerInstanceConfigs []*PerInstanceConfig `json:"perInstanceConfigs,omitempty"` // ForceSendFields is a list of field names (e.g. "PerInstanceConfigs") @@ -32558,42 +32559,42 @@ type PerInstanceConfig struct { // Fingerprint: Fingerprint of this per-instance config. This field can // be used in optimistic locking. It is ignored when inserting a // per-instance config. An up-to-date fingerprint must be provided in - // order to update an existing per-instance config or the field needs to - // be unset. + // order to update an existing per-instance configuration or the field + // needs to be unset. Fingerprint string `json:"fingerprint,omitempty"` - // Name: The name of a per-instance config and its corresponding + // Name: The name of a per-instance configuration and its corresponding // instance. Serves as a merge key during UpdatePerInstanceConfigs - // operations, that is, if a per-instance config with the same name - // exists then it will be updated, otherwise a new one will be created - // for the VM instance with the same name. An attempt to create a - // per-instance config for a VM instance that either doesn't exist or is - // not part of the group will result in an error. + // operations, that is, if a per-instance configuration with the same + // name exists then it will be updated, otherwise a new one will be + // created for the VM instance with the same name. An attempt to create + // a per-instance configconfiguration for a VM instance that either + // doesn't exist or is not part of the group will result in an error. Name string `json:"name,omitempty"` // PreservedState: The intended preserved state for the given instance. // Does not contain preserved state generated from a stateful policy. PreservedState *PreservedState `json:"preservedState,omitempty"` - // Status: The status of applying this per-instance config on the + // Status: The status of applying this per-instance configuration on the // corresponding managed instance. // // Possible values: - // "APPLYING" - The per-instance config is being applied to the + // "APPLYING" - The per-instance configuration is being applied to the // instance, but is not yet effective, possibly waiting for the instance // to, for example, REFRESH. - // "DELETING" - The per-instance config deletion is being applied on - // the instance, possibly waiting for the instance to, for example, - // REFRESH. - // "EFFECTIVE" - The per-instance config is effective on the instance, - // meaning that all disks, ips and metadata specified in this config are - // attached or set on the instance. + // "DELETING" - The per-instance configuration deletion is being + // applied on the instance, possibly waiting for the instance to, for + // example, REFRESH. + // "EFFECTIVE" - The per-instance configuration is effective on the + // instance, meaning that all disks, ips and metadata specified in this + // configuration are attached or set on the instance. // "NONE" - *[Default]* The default status, when no per-instance - // config exists. - // "UNAPPLIED" - The per-instance config is set on an instance but not - // been applied yet. - // "UNAPPLIED_DELETION" - The per-instance config has been deleted, - // but the deletion is not yet applied. + // configuration exists. + // "UNAPPLIED" - The per-instance configuration is set on an instance + // but not been applied yet. + // "UNAPPLIED_DELETION" - The per-instance configuration has been + // deleted, but the deletion is not yet applied. Status string `json:"status,omitempty"` // ForceSendFields is a list of field names (e.g. "Fingerprint") to @@ -35297,8 +35298,8 @@ func (s *RegionInstanceGroupManagerListWarningData) MarshalJSON() ([]byte, error // RegionInstanceGroupManagerPatchInstanceConfigReq: // RegionInstanceGroupManagers.patchPerInstanceConfigs type RegionInstanceGroupManagerPatchInstanceConfigReq struct { - // PerInstanceConfigs: The list of per-instance configs to insert or - // patch on this managed instance group. + // PerInstanceConfigs: The list of per-instance configurations to insert + // or patch on this managed instance group. PerInstanceConfigs []*PerInstanceConfig `json:"perInstanceConfigs,omitempty"` // ForceSendFields is a list of field names (e.g. "PerInstanceConfigs") @@ -35328,8 +35329,8 @@ func (s *RegionInstanceGroupManagerPatchInstanceConfigReq) MarshalJSON() ([]byte // RegionInstanceGroupManagerUpdateInstanceConfigReq: // RegionInstanceGroupManagers.updatePerInstanceConfigs type RegionInstanceGroupManagerUpdateInstanceConfigReq struct { - // PerInstanceConfigs: The list of per-instance configs to insert or - // patch on this managed instance group. + // PerInstanceConfigs: The list of per-instance configurations to insert + // or patch on this managed instance group. PerInstanceConfigs []*PerInstanceConfig `json:"perInstanceConfigs,omitempty"` // ForceSendFields is a list of field names (e.g. "PerInstanceConfigs") @@ -84298,12 +84299,12 @@ type InstanceGroupManagersCreateInstancesCall struct { header_ http.Header } -// CreateInstances: Creates instances with per-instance configs in this -// managed instance group. Instances are created using the current -// instance template. The create instances operation is marked DONE if -// the createInstances request is successful. The underlying actions -// take additional time. You must separately verify the status of the -// creating or actions with the listmanagedinstances method. +// CreateInstances: Creates instances with per-instance configurations +// in this managed instance group. Instances are created using the +// current instance template. The create instances operation is marked +// DONE if the createInstances request is successful. The underlying +// actions take additional time. You must separately verify the status +// of the creating or actions with the listmanagedinstances method. // // - instanceGroupManager: The name of the managed instance group. It // should conform to RFC1035. @@ -84427,7 +84428,7 @@ func (c *InstanceGroupManagersCreateInstancesCall) Do(opts ...googleapi.CallOpti } return ret, nil // { - // "description": "Creates instances with per-instance configs in this managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method.", + // "description": "Creates instances with per-instance configurations in this managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method.", // "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/createInstances", // "httpMethod": "POST", // "id": "compute.instanceGroupManagers.createInstances", @@ -84869,8 +84870,8 @@ type InstanceGroupManagersDeletePerInstanceConfigsCall struct { header_ http.Header } -// DeletePerInstanceConfigs: Deletes selected per-instance configs for -// the managed instance group. +// DeletePerInstanceConfigs: Deletes selected per-instance +// configurations for the managed instance group. // // - instanceGroupManager: The name of the managed instance group. It // should conform to RFC1035. @@ -84979,7 +84980,7 @@ func (c *InstanceGroupManagersDeletePerInstanceConfigsCall) Do(opts ...googleapi } return ret, nil // { - // "description": "Deletes selected per-instance configs for the managed instance group.", + // "description": "Deletes selected per-instance configurations for the managed instance group.", // "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", // "httpMethod": "POST", // "id": "compute.instanceGroupManagers.deletePerInstanceConfigs", @@ -86250,9 +86251,9 @@ type InstanceGroupManagersListPerInstanceConfigsCall struct { header_ http.Header } -// ListPerInstanceConfigs: Lists all of the per-instance configs defined -// for the managed instance group. The orderBy query parameter is not -// supported. +// ListPerInstanceConfigs: Lists all of the per-instance configurations +// defined for the managed instance group. The orderBy query parameter +// is not supported. // // - instanceGroupManager: The name of the managed instance group. It // should conform to RFC1035. @@ -86426,7 +86427,7 @@ func (c *InstanceGroupManagersListPerInstanceConfigsCall) Do(opts ...googleapi.C } return ret, nil // { - // "description": "Lists all of the per-instance configs defined for the managed instance group. The orderBy query parameter is not supported.", + // "description": "Lists all of the per-instance configurations defined for the managed instance group. The orderBy query parameter is not supported.", // "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", // "httpMethod": "POST", // "id": "compute.instanceGroupManagers.listPerInstanceConfigs", @@ -86728,9 +86729,10 @@ type InstanceGroupManagersPatchPerInstanceConfigsCall struct { header_ http.Header } -// PatchPerInstanceConfigs: Inserts or patches per-instance configs for -// the managed instance group. perInstanceConfig.name serves as a key -// used to distinguish whether to perform insert or patch. +// PatchPerInstanceConfigs: Inserts or patches per-instance +// configurations for the managed instance group. perInstanceConfig.name +// serves as a key used to distinguish whether to perform insert or +// patch. // // - instanceGroupManager: The name of the managed instance group. It // should conform to RFC1035. @@ -86855,7 +86857,7 @@ func (c *InstanceGroupManagersPatchPerInstanceConfigsCall) Do(opts ...googleapi. } return ret, nil // { - // "description": "Inserts or patches per-instance configs for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", + // "description": "Inserts or patches per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", // "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", // "httpMethod": "POST", // "id": "compute.instanceGroupManagers.patchPerInstanceConfigs", @@ -87704,9 +87706,10 @@ type InstanceGroupManagersUpdatePerInstanceConfigsCall struct { header_ http.Header } -// UpdatePerInstanceConfigs: Inserts or updates per-instance configs for -// the managed instance group. perInstanceConfig.name serves as a key -// used to distinguish whether to perform insert or patch. +// UpdatePerInstanceConfigs: Inserts or updates per-instance +// configurations for the managed instance group. perInstanceConfig.name +// serves as a key used to distinguish whether to perform insert or +// patch. // // - instanceGroupManager: The name of the managed instance group. It // should conform to RFC1035. @@ -87831,7 +87834,7 @@ func (c *InstanceGroupManagersUpdatePerInstanceConfigsCall) Do(opts ...googleapi } return ret, nil // { - // "description": "Inserts or updates per-instance configs for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", + // "description": "Inserts or updates per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", // "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", // "httpMethod": "POST", // "id": "compute.instanceGroupManagers.updatePerInstanceConfigs", @@ -134205,12 +134208,13 @@ type RegionInstanceGroupManagersCreateInstancesCall struct { header_ http.Header } -// CreateInstances: Creates instances with per-instance configs in this -// regional managed instance group. Instances are created using the -// current instance template. The create instances operation is marked -// DONE if the createInstances request is successful. The underlying -// actions take additional time. You must separately verify the status -// of the creating or actions with the listmanagedinstances method. +// CreateInstances: Creates instances with per-instance configurations +// in this regional managed instance group. Instances are created using +// the current instance template. The create instances operation is +// marked DONE if the createInstances request is successful. The +// underlying actions take additional time. You must separately verify +// the status of the creating or actions with the listmanagedinstances +// method. // // - instanceGroupManager: The name of the managed instance group. It // should conform to RFC1035. @@ -134334,7 +134338,7 @@ func (c *RegionInstanceGroupManagersCreateInstancesCall) Do(opts ...googleapi.Ca } return ret, nil // { - // "description": "Creates instances with per-instance configs in this regional managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method.", + // "description": "Creates instances with per-instance configurations in this regional managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method.", // "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/createInstances", // "httpMethod": "POST", // "id": "compute.regionInstanceGroupManagers.createInstances", @@ -134772,8 +134776,8 @@ type RegionInstanceGroupManagersDeletePerInstanceConfigsCall struct { header_ http.Header } -// DeletePerInstanceConfigs: Deletes selected per-instance configs for -// the managed instance group. +// DeletePerInstanceConfigs: Deletes selected per-instance +// configurations for the managed instance group. // // - instanceGroupManager: The name of the managed instance group. It // should conform to RFC1035. @@ -134882,7 +134886,7 @@ func (c *RegionInstanceGroupManagersDeletePerInstanceConfigsCall) Do(opts ...goo } return ret, nil // { - // "description": "Deletes selected per-instance configs for the managed instance group.", + // "description": "Deletes selected per-instance configurations for the managed instance group.", // "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", // "httpMethod": "POST", // "id": "compute.regionInstanceGroupManagers.deletePerInstanceConfigs", @@ -136145,9 +136149,9 @@ type RegionInstanceGroupManagersListPerInstanceConfigsCall struct { header_ http.Header } -// ListPerInstanceConfigs: Lists all of the per-instance configs defined -// for the managed instance group. The orderBy query parameter is not -// supported. +// ListPerInstanceConfigs: Lists all of the per-instance configurations +// defined for the managed instance group. The orderBy query parameter +// is not supported. // // - instanceGroupManager: The name of the managed instance group. It // should conform to RFC1035. @@ -136321,7 +136325,7 @@ func (c *RegionInstanceGroupManagersListPerInstanceConfigsCall) Do(opts ...googl } return ret, nil // { - // "description": "Lists all of the per-instance configs defined for the managed instance group. The orderBy query parameter is not supported.", + // "description": "Lists all of the per-instance configurations defined for the managed instance group. The orderBy query parameter is not supported.", // "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", // "httpMethod": "POST", // "id": "compute.regionInstanceGroupManagers.listPerInstanceConfigs", @@ -136622,9 +136626,10 @@ type RegionInstanceGroupManagersPatchPerInstanceConfigsCall struct { header_ http.Header } -// PatchPerInstanceConfigs: Inserts or patches per-instance configs for -// the managed instance group. perInstanceConfig.name serves as a key -// used to distinguish whether to perform insert or patch. +// PatchPerInstanceConfigs: Inserts or patches per-instance +// configurations for the managed instance group. perInstanceConfig.name +// serves as a key used to distinguish whether to perform insert or +// patch. // // - instanceGroupManager: The name of the managed instance group. It // should conform to RFC1035. @@ -136749,7 +136754,7 @@ func (c *RegionInstanceGroupManagersPatchPerInstanceConfigsCall) Do(opts ...goog } return ret, nil // { - // "description": "Inserts or patches per-instance configs for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", + // "description": "Inserts or patches per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", // "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", // "httpMethod": "POST", // "id": "compute.regionInstanceGroupManagers.patchPerInstanceConfigs", @@ -137581,9 +137586,10 @@ type RegionInstanceGroupManagersUpdatePerInstanceConfigsCall struct { header_ http.Header } -// UpdatePerInstanceConfigs: Inserts or updates per-instance configs for -// the managed instance group. perInstanceConfig.name serves as a key -// used to distinguish whether to perform insert or patch. +// UpdatePerInstanceConfigs: Inserts or updates per-instance +// configurations for the managed instance group. perInstanceConfig.name +// serves as a key used to distinguish whether to perform insert or +// patch. // // - instanceGroupManager: The name of the managed instance group. It // should conform to RFC1035. @@ -137708,7 +137714,7 @@ func (c *RegionInstanceGroupManagersUpdatePerInstanceConfigsCall) Do(opts ...goo } return ret, nil // { - // "description": "Inserts or updates per-instance configs for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", + // "description": "Inserts or updates per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch.", // "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", // "httpMethod": "POST", // "id": "compute.regionInstanceGroupManagers.updatePerInstanceConfigs", diff --git a/container/v1/container-api.json b/container/v1/container-api.json index c160c499230..ba49c934034 100644 --- a/container/v1/container-api.json +++ b/container/v1/container-api.json @@ -2459,7 +2459,7 @@ } } }, - "revision": "20220312", + "revision": "20220328", "rootUrl": "https://container.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -3430,7 +3430,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" @@ -3773,7 +3773,7 @@ "additionalProperties": { "type": "string" }, - "description": "The Linux kernel parameters to be applied to the nodes and all pods running on the nodes. The following parameters are supported. net.core.netdev_max_backlog net.core.rmem_max net.core.wmem_default net.core.wmem_max net.core.optmem_max net.core.somaxconn net.ipv4.tcp_rmem net.ipv4.tcp_wmem net.ipv4.tcp_tw_reuse", + "description": "The Linux kernel parameters to be applied to the nodes and all pods running on the nodes. The following parameters are supported. net.core.busy_poll net.core.busy_read net.core.netdev_max_backlog net.core.rmem_max net.core.wmem_default net.core.wmem_max net.core.optmem_max net.core.somaxconn net.ipv4.tcp_rmem net.ipv4.tcp_wmem net.ipv4.tcp_tw_reuse", "type": "object" } }, @@ -4346,6 +4346,25 @@ "cpuManagerPolicy": { "description": "Control the CPU management policy on the node. See https://kubernetes.io/docs/tasks/administer-cluster/cpu-management-policies/ The following values are allowed. * \"none\": the default, which represents the existing scheduling behavior. * \"static\": allows pods with certain resource characteristics to be granted increased CPU affinity and exclusivity on the node. The default value is 'none' if unspecified.", "type": "string" + }, + "podPidsLimit": { + "description": "Set the Pod PID limits. See https://kubernetes.io/docs/concepts/policy/pid-limiting/#pod-pid-limits Controls the maximum number of processes allowed to run in a pod. The value must be greater than or equal to 1024 and less than 4194304.", + "format": "int64", + "type": "string" + } + }, + "type": "object" + }, + "NodeLabels": { + "description": "Collection of node-level [Kubernetes labels](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels).", + "id": "NodeLabels", + "properties": { + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Map of node label keys and node label values.", + "type": "object" } }, "type": "object" @@ -4566,6 +4585,20 @@ }, "type": "object" }, + "NodeTaints": { + "description": "Collection of Kubernetes [node taints](https://kubernetes.io/docs/concepts/configuration/taint-and-toleration).", + "id": "NodeTaints", + "properties": { + "taints": { + "description": "List of node taints.", + "items": { + "$ref": "NodeTaint" + }, + "type": "array" + } + }, + "type": "object" + }, "NotificationConfig": { "description": "NotificationConfig is the configuration of notifications.", "id": "NotificationConfig", @@ -5731,6 +5764,10 @@ "$ref": "NodeKubeletConfig", "description": "Node kubelet configs." }, + "labels": { + "$ref": "NodeLabels", + "description": "The desired node labels to be applied to all nodes in the node pool. If this field is not present, the labels will not be changed. Otherwise, the existing node labels will be *replaced* with the provided labels." + }, "linuxNodeConfig": { "$ref": "LinuxNodeConfig", "description": "Parameters that can be configured on Linux nodes." @@ -5758,6 +5795,14 @@ "description": "Deprecated. The Google Developers Console [project ID or project number](https://support.google.com/cloud/answer/6158840). This field has been deprecated and replaced by the name field.", "type": "string" }, + "tags": { + "$ref": "NetworkTags", + "description": "The desired network tags to be applied to all nodes in the node pool. If this field is not present, the tags will not be changed. Otherwise, the existing network tags will be *replaced* with the provided tags." + }, + "taints": { + "$ref": "NodeTaints", + "description": "The desired node taints to be applied to all nodes in the node pool. If this field is not present, the taints will not be changed. Otherwise, the existing node taints will be *replaced* with the provided taints." + }, "upgradeSettings": { "$ref": "UpgradeSettings", "description": "Upgrade settings control disruption and speed of the upgrade." diff --git a/container/v1/container-gen.go b/container/v1/container-gen.go index ecee43dacf4..f879fbdf8c6 100644 --- a/container/v1/container-gen.go +++ b/container/v1/container-gen.go @@ -1849,8 +1849,7 @@ func (s *DnsCacheConfig) 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. @@ -2505,10 +2504,10 @@ func (s *LegacyAbac) MarshalJSON() ([]byte, error) { type LinuxNodeConfig struct { // Sysctls: The Linux kernel parameters to be applied to the nodes and // all pods running on the nodes. The following parameters are - // supported. net.core.netdev_max_backlog net.core.rmem_max - // net.core.wmem_default net.core.wmem_max net.core.optmem_max - // net.core.somaxconn net.ipv4.tcp_rmem net.ipv4.tcp_wmem - // net.ipv4.tcp_tw_reuse + // supported. net.core.busy_poll net.core.busy_read + // net.core.netdev_max_backlog net.core.rmem_max net.core.wmem_default + // net.core.wmem_max net.core.optmem_max net.core.somaxconn + // net.ipv4.tcp_rmem net.ipv4.tcp_wmem net.ipv4.tcp_tw_reuse Sysctls map[string]string `json:"sysctls,omitempty"` // ForceSendFields is a list of field names (e.g. "Sysctls") to @@ -3573,6 +3572,12 @@ type NodeKubeletConfig struct { // unspecified. CpuManagerPolicy string `json:"cpuManagerPolicy,omitempty"` + // PodPidsLimit: Set the Pod PID limits. See + // https://kubernetes.io/docs/concepts/policy/pid-limiting/#pod-pid-limits + // Controls the maximum number of processes allowed to run in a pod. The + // value must be greater than or equal to 1024 and less than 4194304. + PodPidsLimit int64 `json:"podPidsLimit,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "CpuCfsQuota") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -3596,6 +3601,35 @@ func (s *NodeKubeletConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// NodeLabels: Collection of node-level Kubernetes labels +// (https://kubernetes.io/docs/concepts/overview/working-with-objects/labels). +type NodeLabels struct { + // Labels: Map of node label keys and node label values. + Labels map[string]string `json:"labels,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Labels") 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. "Labels") 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 *NodeLabels) MarshalJSON() ([]byte, error) { + type NoMethod NodeLabels + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // NodeManagement: NodeManagement defines the set of node management // services turned on for the node pool. type NodeManagement struct { @@ -3959,6 +3993,35 @@ func (s *NodeTaint) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// NodeTaints: Collection of Kubernetes node taints +// (https://kubernetes.io/docs/concepts/configuration/taint-and-toleration). +type NodeTaints struct { + // Taints: List of node taints. + Taints []*NodeTaint `json:"taints,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Taints") 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. "Taints") 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 *NodeTaints) MarshalJSON() ([]byte, error) { + type NoMethod NodeTaints + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // NotificationConfig: NotificationConfig is the configuration of // notifications. type NotificationConfig struct { @@ -5885,6 +5948,12 @@ type UpdateNodePoolRequest struct { // KubeletConfig: Node kubelet configs. KubeletConfig *NodeKubeletConfig `json:"kubeletConfig,omitempty"` + // Labels: The desired node labels to be applied to all nodes in the + // node pool. If this field is not present, the labels will not be + // changed. Otherwise, the existing node labels will be *replaced* with + // the provided labels. + Labels *NodeLabels `json:"labels,omitempty"` + // LinuxNodeConfig: Parameters that can be configured on Linux nodes. LinuxNodeConfig *LinuxNodeConfig `json:"linuxNodeConfig,omitempty"` @@ -5920,6 +5989,18 @@ type UpdateNodePoolRequest struct { // This field has been deprecated and replaced by the name field. ProjectId string `json:"projectId,omitempty"` + // Tags: The desired network tags to be applied to all nodes in the node + // pool. If this field is not present, the tags will not be changed. + // Otherwise, the existing network tags will be *replaced* with the + // provided tags. + Tags *NetworkTags `json:"tags,omitempty"` + + // Taints: The desired node taints to be applied to all nodes in the + // node pool. If this field is not present, the taints will not be + // changed. Otherwise, the existing node taints will be *replaced* with + // the provided taints. + Taints *NodeTaints `json:"taints,omitempty"` + // UpgradeSettings: Upgrade settings control disruption and speed of the // upgrade. UpgradeSettings *UpgradeSettings `json:"upgradeSettings,omitempty"` diff --git a/container/v1beta1/container-api.json b/container/v1beta1/container-api.json index bff876ee66e..1bea9742d28 100644 --- a/container/v1beta1/container-api.json +++ b/container/v1beta1/container-api.json @@ -2484,7 +2484,7 @@ } } }, - "revision": "20220308", + "revision": "20220328", "rootUrl": "https://container.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -2697,7 +2697,7 @@ "id": "BinaryAuthorization", "properties": { "enabled": { - "description": "Enable Binary Authorization for this cluster. If enabled, all container images will be validated by Google Binauthz.", + "description": "Enable Binary Authorization for this cluster. If enabled, all container images will be validated by Binary Authorization.", "type": "boolean" } }, @@ -3585,7 +3585,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" @@ -3989,7 +3989,7 @@ "additionalProperties": { "type": "string" }, - "description": "The Linux kernel parameters to be applied to the nodes and all pods running on the nodes. The following parameters are supported. net.core.netdev_max_backlog net.core.rmem_max net.core.wmem_default net.core.wmem_max net.core.optmem_max net.core.somaxconn net.ipv4.tcp_rmem net.ipv4.tcp_wmem net.ipv4.tcp_tw_reuse", + "description": "The Linux kernel parameters to be applied to the nodes and all pods running on the nodes. The following parameters are supported. net.core.busy_poll net.core.busy_read net.core.netdev_max_backlog net.core.rmem_max net.core.wmem_default net.core.wmem_max net.core.optmem_max net.core.somaxconn net.ipv4.tcp_rmem net.ipv4.tcp_wmem net.ipv4.tcp_tw_reuse", "type": "object" } }, @@ -4639,6 +4639,11 @@ "cpuManagerPolicy": { "description": "Control the CPU management policy on the node. See https://kubernetes.io/docs/tasks/administer-cluster/cpu-management-policies/ The following values are allowed. * \"none\": the default, which represents the existing scheduling behavior. * \"static\": allows pods with certain resource characteristics to be granted increased CPU affinity and exclusivity on the node. The default value is 'none' if unspecified.", "type": "string" + }, + "podPidsLimit": { + "description": "Set the Pod PID limits. See https://kubernetes.io/docs/concepts/policy/pid-limiting/#pod-pid-limits Controls the maximum number of processes allowed to run in a pod. The value must be greater than or equal to 1024 and less than 4194304.", + "format": "int64", + "type": "string" } }, "type": "object" diff --git a/container/v1beta1/container-gen.go b/container/v1beta1/container-gen.go index 055a4bf2a96..a8f00c81b7b 100644 --- a/container/v1beta1/container-gen.go +++ b/container/v1beta1/container-gen.go @@ -690,7 +690,7 @@ func (s *BigQueryDestination) MarshalJSON() ([]byte, error) { // BinaryAuthorization: Configuration for Binary Authorization. type BinaryAuthorization struct { // Enabled: Enable Binary Authorization for this cluster. If enabled, - // all container images will be validated by Google Binauthz. + // all container images will be validated by Binary Authorization. Enabled bool `json:"enabled,omitempty"` // ForceSendFields is a list of field names (e.g. "Enabled") to @@ -2047,8 +2047,7 @@ func (s *DnsCacheConfig) 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. @@ -2840,10 +2839,10 @@ func (s *LegacyAbac) MarshalJSON() ([]byte, error) { type LinuxNodeConfig struct { // Sysctls: The Linux kernel parameters to be applied to the nodes and // all pods running on the nodes. The following parameters are - // supported. net.core.netdev_max_backlog net.core.rmem_max - // net.core.wmem_default net.core.wmem_max net.core.optmem_max - // net.core.somaxconn net.ipv4.tcp_rmem net.ipv4.tcp_wmem - // net.ipv4.tcp_tw_reuse + // supported. net.core.busy_poll net.core.busy_read + // net.core.netdev_max_backlog net.core.rmem_max net.core.wmem_default + // net.core.wmem_max net.core.optmem_max net.core.somaxconn + // net.ipv4.tcp_rmem net.ipv4.tcp_wmem net.ipv4.tcp_tw_reuse Sysctls map[string]string `json:"sysctls,omitempty"` // ForceSendFields is a list of field names (e.g. "Sysctls") to @@ -4039,6 +4038,12 @@ type NodeKubeletConfig struct { // unspecified. CpuManagerPolicy string `json:"cpuManagerPolicy,omitempty"` + // PodPidsLimit: Set the Pod PID limits. See + // https://kubernetes.io/docs/concepts/policy/pid-limiting/#pod-pid-limits + // Controls the maximum number of processes allowed to run in a pod. The + // value must be greater than or equal to 1024 and less than 4194304. + PodPidsLimit int64 `json:"podPidsLimit,omitempty,string"` + // ForceSendFields is a list of field names (e.g. "CpuCfsQuota") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any diff --git a/datacatalog/v1/datacatalog-api.json b/datacatalog/v1/datacatalog-api.json index c2d4f87e2ba..fced11eba38 100644 --- a/datacatalog/v1/datacatalog-api.json +++ b/datacatalog/v1/datacatalog-api.json @@ -1953,7 +1953,7 @@ } } }, - "revision": "20220321", + "revision": "20220409", "rootUrl": "https://datacatalog.googleapis.com/", "schemas": { "Binding": { @@ -1965,7 +1965,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" }, @@ -3586,7 +3586,7 @@ "type": "string" }, "displayName": { - "description": "Required. User-defined name of this taxonomy. The name can't start or end with spaces, must contain only Unicode letters, numbers, underscores, dashes, and spaces, and be at most 200 bytes long when encoded in UTF-8.", + "description": "Required. User-defined name of this taxonomy. The name can't start or end with spaces, must contain only Unicode letters, numbers, underscores, dashes, and spaces, and be at most 200 bytes long when encoded in UTF-8. The taxonomy display name must be unique within an organization.", "type": "string" }, "name": { @@ -3708,7 +3708,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." } }, "type": "object" @@ -3718,7 +3718,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/datacatalog/v1/datacatalog-gen.go b/datacatalog/v1/datacatalog-gen.go index da6d91ac9d7..c7db087bce3 100644 --- a/datacatalog/v1/datacatalog-gen.go +++ b/datacatalog/v1/datacatalog-gen.go @@ -302,8 +302,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 @@ -3306,7 +3306,8 @@ type GoogleCloudDatacatalogV1Taxonomy struct { // DisplayName: Required. User-defined name of this taxonomy. The name // can't start or end with spaces, must contain only Unicode letters, // numbers, underscores, dashes, and spaces, and be at most 200 bytes - // long when encoded in UTF-8. + // long when encoded in UTF-8. The taxonomy display name must be unique + // within an organization. DisplayName string `json:"displayName,omitempty"` // Name: Output only. Resource name of this taxonomy in URL format. @@ -3603,7 +3604,7 @@ func (s *Policy) 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"` @@ -3634,7 +3635,7 @@ func (s *SetIamPolicyRequest) 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"` diff --git a/datacatalog/v1beta1/datacatalog-api.json b/datacatalog/v1beta1/datacatalog-api.json index 4781a873b23..90d406fdcb5 100644 --- a/datacatalog/v1beta1/datacatalog-api.json +++ b/datacatalog/v1beta1/datacatalog-api.json @@ -1808,7 +1808,7 @@ } } }, - "revision": "20220321", + "revision": "20220409", "rootUrl": "https://datacatalog.googleapis.com/", "schemas": { "Binding": { @@ -1820,7 +1820,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" }, @@ -2774,7 +2774,7 @@ "type": "string" }, "displayName": { - "description": "Required. User defined name of this taxonomy. It must: contain only unicode letters, numbers, underscores, dashes and spaces; not start or end with spaces; and be at most 200 bytes long when encoded in UTF-8.", + "description": "Required. User defined name of this taxonomy. It must: contain only unicode letters, numbers, underscores, dashes and spaces; not start or end with spaces; and be at most 200 bytes long when encoded in UTF-8. The taxonomy display name must be unique within an organization.", "type": "string" }, "name": { @@ -2884,7 +2884,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." } }, "type": "object" @@ -2894,7 +2894,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/datacatalog/v1beta1/datacatalog-gen.go b/datacatalog/v1beta1/datacatalog-gen.go index dff36ecfa62..287a95701e6 100644 --- a/datacatalog/v1beta1/datacatalog-gen.go +++ b/datacatalog/v1beta1/datacatalog-gen.go @@ -302,8 +302,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 @@ -2160,7 +2160,8 @@ type GoogleCloudDatacatalogV1beta1Taxonomy struct { // DisplayName: Required. User defined name of this taxonomy. It must: // contain only unicode letters, numbers, underscores, dashes and // spaces; not start or end with spaces; and be at most 200 bytes long - // when encoded in UTF-8. + // when encoded in UTF-8. The taxonomy display name must be unique + // within an organization. DisplayName string `json:"displayName,omitempty"` // Name: Output only. Resource name of this taxonomy, whose format is: @@ -2444,7 +2445,7 @@ func (s *Policy) 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"` @@ -2475,7 +2476,7 @@ func (s *SetIamPolicyRequest) 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"` diff --git a/datamigration/v1/datamigration-api.json b/datamigration/v1/datamigration-api.json index b693f3f3aa3..1ba67d1437b 100644 --- a/datamigration/v1/datamigration-api.json +++ b/datamigration/v1/datamigration-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" }, @@ -1049,7 +1049,7 @@ } } }, - "revision": "20220321", + "revision": "20220406", "rootUrl": "https://datamigration.googleapis.com/", "schemas": { "AuditConfig": { @@ -1109,7 +1109,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" }, @@ -2068,7 +2068,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\"`", @@ -2224,7 +2224,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/datamigration/v1/datamigration-gen.go b/datamigration/v1/datamigration-gen.go index d5a9885bbb2..e4d46340164 100644 --- a/datamigration/v1/datamigration-gen.go +++ b/datamigration/v1/datamigration-gen.go @@ -303,8 +303,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 @@ -1663,7 +1663,7 @@ func (s *ReverseSshConnectivity) 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"` @@ -1931,7 +1931,7 @@ type StopMigrationJobRequest struct { // 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"` @@ -2261,8 +2261,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 @@ -2391,7 +2391,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/datamigration/v1beta1/datamigration-api.json b/datamigration/v1beta1/datamigration-api.json index 822d1cd28d4..f62bc3c40c6 100644 --- a/datamigration/v1beta1/datamigration-api.json +++ b/datamigration/v1beta1/datamigration-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" }, @@ -1049,7 +1049,7 @@ } } }, - "revision": "20220321", + "revision": "20220406", "rootUrl": "https://datamigration.googleapis.com/", "schemas": { "AuditConfig": { @@ -1109,7 +1109,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" }, @@ -1946,7 +1946,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\"`", @@ -2102,7 +2102,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/datamigration/v1beta1/datamigration-gen.go b/datamigration/v1beta1/datamigration-gen.go index fc81defbdfc..bece2a03702 100644 --- a/datamigration/v1beta1/datamigration-gen.go +++ b/datamigration/v1beta1/datamigration-gen.go @@ -303,8 +303,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 @@ -1505,7 +1505,7 @@ func (s *ReverseSshConnectivity) 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"` @@ -1773,7 +1773,7 @@ type StopMigrationJobRequest struct { // 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"` @@ -2103,8 +2103,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 @@ -2233,7 +2233,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/dialogflow/v2/dialogflow-api.json b/dialogflow/v2/dialogflow-api.json index 5c657774212..d9d69f41669 100644 --- a/dialogflow/v2/dialogflow-api.json +++ b/dialogflow/v2/dialogflow-api.json @@ -8077,7 +8077,7 @@ } } }, - "revision": "20220404", + "revision": "20220411", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AudioInput": { @@ -8589,7 +8589,7 @@ "type": "array" }, "tag": { - "description": "The tag used by the webhook to identify which fulfillment is being called. This field is required if `webhook` is specified.", + "description": "The value of this field will be populated in the WebhookRequest `fulfillmentInfo.tag` field by Dialogflow when the associated webhook is called. The tag is typically used by the webhook service to identify which fulfillment is being called, but it could be used for other purposes. This field is required if `webhook` is specified.", "type": "string" }, "webhook": { @@ -8946,7 +8946,7 @@ "id": "GoogleCloudDialogflowCxV3Page", "properties": { "displayName": { - "description": "Required. The human-readable name of the page, unique within the agent.", + "description": "Required. The human-readable name of the page, unique within the flow.", "type": "string" }, "entryFulfillment": { @@ -9644,7 +9644,7 @@ "id": "GoogleCloudDialogflowCxV3WebhookRequestFulfillmentInfo", "properties": { "tag": { - "description": "Always present. The tag used to identify which fulfillment is being called.", + "description": "Always present. The value of the Fulfillment.tag field will be populated in this field by Dialogflow when the associated webhook is called. The tag is typically used by the webhook service to identify which fulfillment is being called, but it could be used for other purposes.", "type": "string" } }, @@ -10281,7 +10281,7 @@ "type": "array" }, "tag": { - "description": "The tag used by the webhook to identify which fulfillment is being called. This field is required if `webhook` is specified.", + "description": "The value of this field will be populated in the WebhookRequest `fulfillmentInfo.tag` field by Dialogflow when the associated webhook is called. The tag is typically used by the webhook service to identify which fulfillment is being called, but it could be used for other purposes. This field is required if `webhook` is specified.", "type": "string" }, "webhook": { @@ -10638,7 +10638,7 @@ "id": "GoogleCloudDialogflowCxV3beta1Page", "properties": { "displayName": { - "description": "Required. The human-readable name of the page, unique within the agent.", + "description": "Required. The human-readable name of the page, unique within the flow.", "type": "string" }, "entryFulfillment": { @@ -11336,7 +11336,7 @@ "id": "GoogleCloudDialogflowCxV3beta1WebhookRequestFulfillmentInfo", "properties": { "tag": { - "description": "Always present. The tag used to identify which fulfillment is being called.", + "description": "Always present. The value of the Fulfillment.tag field will be populated in this field by Dialogflow when the associated webhook is called. The tag is typically used by the webhook service to identify which fulfillment is being called, but it could be used for other purposes.", "type": "string" } }, diff --git a/dialogflow/v2/dialogflow-gen.go b/dialogflow/v2/dialogflow-gen.go index fa4796f8968..36fdd010c80 100644 --- a/dialogflow/v2/dialogflow-gen.go +++ b/dialogflow/v2/dialogflow-gen.go @@ -1773,8 +1773,11 @@ type GoogleCloudDialogflowCxV3Fulfillment struct { // webhook. SetParameterActions []*GoogleCloudDialogflowCxV3FulfillmentSetParameterAction `json:"setParameterActions,omitempty"` - // Tag: The tag used by the webhook to identify which fulfillment is - // being called. This field is required if `webhook` is specified. + // Tag: The value of this field will be populated in the WebhookRequest + // `fulfillmentInfo.tag` field by Dialogflow when the associated webhook + // is called. The tag is typically used by the webhook service to + // identify which fulfillment is being called, but it could be used for + // other purposes. This field is required if `webhook` is specified. Tag string `json:"tag,omitempty"` // Webhook: The webhook to call. Format: @@ -2505,7 +2508,7 @@ func (s *GoogleCloudDialogflowCxV3IntentTrainingPhrasePart) MarshalJSON() ([]byt // (https://cloud.google.com/dialogflow/cx/docs/concept/page). type GoogleCloudDialogflowCxV3Page struct { // DisplayName: Required. The human-readable name of the page, unique - // within the agent. + // within the flow. DisplayName string `json:"displayName,omitempty"` // EntryFulfillment: The fulfillment to call when the session is @@ -3774,8 +3777,11 @@ func (s *GoogleCloudDialogflowCxV3WebhookRequest) MarshalJSON() ([]byte, error) // GoogleCloudDialogflowCxV3WebhookRequestFulfillmentInfo: Represents // fulfillment information communicated to the webhook. type GoogleCloudDialogflowCxV3WebhookRequestFulfillmentInfo struct { - // Tag: Always present. The tag used to identify which fulfillment is - // being called. + // Tag: Always present. The value of the Fulfillment.tag field will be + // populated in this field by Dialogflow when the associated webhook is + // called. The tag is typically used by the webhook service to identify + // which fulfillment is being called, but it could be used for other + // purposes. Tag string `json:"tag,omitempty"` // ForceSendFields is a list of field names (e.g. "Tag") to @@ -4996,8 +5002,11 @@ type GoogleCloudDialogflowCxV3beta1Fulfillment struct { // webhook. SetParameterActions []*GoogleCloudDialogflowCxV3beta1FulfillmentSetParameterAction `json:"setParameterActions,omitempty"` - // Tag: The tag used by the webhook to identify which fulfillment is - // being called. This field is required if `webhook` is specified. + // Tag: The value of this field will be populated in the WebhookRequest + // `fulfillmentInfo.tag` field by Dialogflow when the associated webhook + // is called. The tag is typically used by the webhook service to + // identify which fulfillment is being called, but it could be used for + // other purposes. This field is required if `webhook` is specified. Tag string `json:"tag,omitempty"` // Webhook: The webhook to call. Format: @@ -5730,7 +5739,7 @@ func (s *GoogleCloudDialogflowCxV3beta1IntentTrainingPhrasePart) MarshalJSON() ( // (https://cloud.google.com/dialogflow/cx/docs/concept/page). type GoogleCloudDialogflowCxV3beta1Page struct { // DisplayName: Required. The human-readable name of the page, unique - // within the agent. + // within the flow. DisplayName string `json:"displayName,omitempty"` // EntryFulfillment: The fulfillment to call when the session is @@ -7001,8 +7010,11 @@ func (s *GoogleCloudDialogflowCxV3beta1WebhookRequest) MarshalJSON() ([]byte, er // GoogleCloudDialogflowCxV3beta1WebhookRequestFulfillmentInfo: // Represents fulfillment information communicated to the webhook. type GoogleCloudDialogflowCxV3beta1WebhookRequestFulfillmentInfo struct { - // Tag: Always present. The tag used to identify which fulfillment is - // being called. + // Tag: Always present. The value of the Fulfillment.tag field will be + // populated in this field by Dialogflow when the associated webhook is + // called. The tag is typically used by the webhook service to identify + // which fulfillment is being called, but it could be used for other + // purposes. Tag string `json:"tag,omitempty"` // ForceSendFields is a list of field names (e.g. "Tag") to diff --git a/dialogflow/v2beta1/dialogflow-api.json b/dialogflow/v2beta1/dialogflow-api.json index 94337bc677e..10877c34bcd 100644 --- a/dialogflow/v2beta1/dialogflow-api.json +++ b/dialogflow/v2beta1/dialogflow-api.json @@ -7431,7 +7431,7 @@ } } }, - "revision": "20220404", + "revision": "20220411", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AudioInput": { @@ -7943,7 +7943,7 @@ "type": "array" }, "tag": { - "description": "The tag used by the webhook to identify which fulfillment is being called. This field is required if `webhook` is specified.", + "description": "The value of this field will be populated in the WebhookRequest `fulfillmentInfo.tag` field by Dialogflow when the associated webhook is called. The tag is typically used by the webhook service to identify which fulfillment is being called, but it could be used for other purposes. This field is required if `webhook` is specified.", "type": "string" }, "webhook": { @@ -8300,7 +8300,7 @@ "id": "GoogleCloudDialogflowCxV3Page", "properties": { "displayName": { - "description": "Required. The human-readable name of the page, unique within the agent.", + "description": "Required. The human-readable name of the page, unique within the flow.", "type": "string" }, "entryFulfillment": { @@ -8998,7 +8998,7 @@ "id": "GoogleCloudDialogflowCxV3WebhookRequestFulfillmentInfo", "properties": { "tag": { - "description": "Always present. The tag used to identify which fulfillment is being called.", + "description": "Always present. The value of the Fulfillment.tag field will be populated in this field by Dialogflow when the associated webhook is called. The tag is typically used by the webhook service to identify which fulfillment is being called, but it could be used for other purposes.", "type": "string" } }, @@ -9635,7 +9635,7 @@ "type": "array" }, "tag": { - "description": "The tag used by the webhook to identify which fulfillment is being called. This field is required if `webhook` is specified.", + "description": "The value of this field will be populated in the WebhookRequest `fulfillmentInfo.tag` field by Dialogflow when the associated webhook is called. The tag is typically used by the webhook service to identify which fulfillment is being called, but it could be used for other purposes. This field is required if `webhook` is specified.", "type": "string" }, "webhook": { @@ -9992,7 +9992,7 @@ "id": "GoogleCloudDialogflowCxV3beta1Page", "properties": { "displayName": { - "description": "Required. The human-readable name of the page, unique within the agent.", + "description": "Required. The human-readable name of the page, unique within the flow.", "type": "string" }, "entryFulfillment": { @@ -10690,7 +10690,7 @@ "id": "GoogleCloudDialogflowCxV3beta1WebhookRequestFulfillmentInfo", "properties": { "tag": { - "description": "Always present. The tag used to identify which fulfillment is being called.", + "description": "Always present. The value of the Fulfillment.tag field will be populated in this field by Dialogflow when the associated webhook is called. The tag is typically used by the webhook service to identify which fulfillment is being called, but it could be used for other purposes.", "type": "string" } }, diff --git a/dialogflow/v2beta1/dialogflow-gen.go b/dialogflow/v2beta1/dialogflow-gen.go index 5d87747c7b1..aa79c6425b5 100644 --- a/dialogflow/v2beta1/dialogflow-gen.go +++ b/dialogflow/v2beta1/dialogflow-gen.go @@ -1701,8 +1701,11 @@ type GoogleCloudDialogflowCxV3Fulfillment struct { // webhook. SetParameterActions []*GoogleCloudDialogflowCxV3FulfillmentSetParameterAction `json:"setParameterActions,omitempty"` - // Tag: The tag used by the webhook to identify which fulfillment is - // being called. This field is required if `webhook` is specified. + // Tag: The value of this field will be populated in the WebhookRequest + // `fulfillmentInfo.tag` field by Dialogflow when the associated webhook + // is called. The tag is typically used by the webhook service to + // identify which fulfillment is being called, but it could be used for + // other purposes. This field is required if `webhook` is specified. Tag string `json:"tag,omitempty"` // Webhook: The webhook to call. Format: @@ -2433,7 +2436,7 @@ func (s *GoogleCloudDialogflowCxV3IntentTrainingPhrasePart) MarshalJSON() ([]byt // (https://cloud.google.com/dialogflow/cx/docs/concept/page). type GoogleCloudDialogflowCxV3Page struct { // DisplayName: Required. The human-readable name of the page, unique - // within the agent. + // within the flow. DisplayName string `json:"displayName,omitempty"` // EntryFulfillment: The fulfillment to call when the session is @@ -3702,8 +3705,11 @@ func (s *GoogleCloudDialogflowCxV3WebhookRequest) MarshalJSON() ([]byte, error) // GoogleCloudDialogflowCxV3WebhookRequestFulfillmentInfo: Represents // fulfillment information communicated to the webhook. type GoogleCloudDialogflowCxV3WebhookRequestFulfillmentInfo struct { - // Tag: Always present. The tag used to identify which fulfillment is - // being called. + // Tag: Always present. The value of the Fulfillment.tag field will be + // populated in this field by Dialogflow when the associated webhook is + // called. The tag is typically used by the webhook service to identify + // which fulfillment is being called, but it could be used for other + // purposes. Tag string `json:"tag,omitempty"` // ForceSendFields is a list of field names (e.g. "Tag") to @@ -4924,8 +4930,11 @@ type GoogleCloudDialogflowCxV3beta1Fulfillment struct { // webhook. SetParameterActions []*GoogleCloudDialogflowCxV3beta1FulfillmentSetParameterAction `json:"setParameterActions,omitempty"` - // Tag: The tag used by the webhook to identify which fulfillment is - // being called. This field is required if `webhook` is specified. + // Tag: The value of this field will be populated in the WebhookRequest + // `fulfillmentInfo.tag` field by Dialogflow when the associated webhook + // is called. The tag is typically used by the webhook service to + // identify which fulfillment is being called, but it could be used for + // other purposes. This field is required if `webhook` is specified. Tag string `json:"tag,omitempty"` // Webhook: The webhook to call. Format: @@ -5658,7 +5667,7 @@ func (s *GoogleCloudDialogflowCxV3beta1IntentTrainingPhrasePart) MarshalJSON() ( // (https://cloud.google.com/dialogflow/cx/docs/concept/page). type GoogleCloudDialogflowCxV3beta1Page struct { // DisplayName: Required. The human-readable name of the page, unique - // within the agent. + // within the flow. DisplayName string `json:"displayName,omitempty"` // EntryFulfillment: The fulfillment to call when the session is @@ -6929,8 +6938,11 @@ func (s *GoogleCloudDialogflowCxV3beta1WebhookRequest) MarshalJSON() ([]byte, er // GoogleCloudDialogflowCxV3beta1WebhookRequestFulfillmentInfo: // Represents fulfillment information communicated to the webhook. type GoogleCloudDialogflowCxV3beta1WebhookRequestFulfillmentInfo struct { - // Tag: Always present. The tag used to identify which fulfillment is - // being called. + // Tag: Always present. The value of the Fulfillment.tag field will be + // populated in this field by Dialogflow when the associated webhook is + // called. The tag is typically used by the webhook service to identify + // which fulfillment is being called, but it could be used for other + // purposes. Tag string `json:"tag,omitempty"` // ForceSendFields is a list of field names (e.g. "Tag") to diff --git a/dialogflow/v3/dialogflow-api.json b/dialogflow/v3/dialogflow-api.json index e5679e9a9cf..dee165439e6 100644 --- a/dialogflow/v3/dialogflow-api.json +++ b/dialogflow/v3/dialogflow-api.json @@ -3078,7 +3078,7 @@ ] }, "import": { - "description": "Imports the test cases from a Cloud Storage bucket or a local file. It always creates new test cases and won't overwite any existing ones. The provided ID in the imported test case is neglected. This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: - `metadata`: ImportTestCasesMetadata - `response`: ImportTestCasesResponse", + "description": "Imports the test cases from a Cloud Storage bucket or a local file. It always creates new test cases and won't overwrite any existing ones. The provided ID in the imported test case is neglected. This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: - `metadata`: ImportTestCasesMetadata - `response`: ImportTestCasesResponse", "flatPath": "v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/testCases:import", "httpMethod": "POST", "id": "dialogflow.projects.locations.agents.testCases.import", @@ -3820,7 +3820,7 @@ } } }, - "revision": "20220404", + "revision": "20220411", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AdvancedSettings": { @@ -5036,7 +5036,7 @@ "type": "array" }, "transitionRoutes": { - "description": "A flow's transition routes serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition routes and can support use cases such as the user saying \"help\" or \"can I talk to a human?\", which can be handled in a common way regardless of the current page. Transition routes defined in the page have higher priority than those defined in the flow. TransitionRoutes are evalauted in the following order: * TransitionRoutes with intent specified.. * TransitionRoutes with only condition specified. TransitionRoutes with intent specified are inherited by pages in the flow.", + "description": "A flow's transition routes serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition routes and can support use cases such as the user saying \"help\" or \"can I talk to a human?\", which can be handled in a common way regardless of the current page. Transition routes defined in the page have higher priority than those defined in the flow. TransitionRoutes are evalauted in the following order: * TransitionRoutes with intent specified. * TransitionRoutes with only condition specified. TransitionRoutes with intent specified are inherited by pages in the flow.", "items": { "$ref": "GoogleCloudDialogflowCxV3TransitionRoute" }, @@ -5208,7 +5208,7 @@ "type": "array" }, "tag": { - "description": "The tag used by the webhook to identify which fulfillment is being called. This field is required if `webhook` is specified.", + "description": "The value of this field will be populated in the WebhookRequest `fulfillmentInfo.tag` field by Dialogflow when the associated webhook is called. The tag is typically used by the webhook service to identify which fulfillment is being called, but it could be used for other purposes. This field is required if `webhook` is specified.", "type": "string" }, "webhook": { @@ -6159,7 +6159,7 @@ "id": "GoogleCloudDialogflowCxV3Page", "properties": { "displayName": { - "description": "Required. The human-readable name of the page, unique within the agent.", + "description": "Required. The human-readable name of the page, unique within the flow.", "type": "string" }, "entryFulfillment": { @@ -7322,7 +7322,7 @@ "id": "GoogleCloudDialogflowCxV3TransitionRouteGroup", "properties": { "displayName": { - "description": "Required. The human-readable name of the transition route group, unique within the Agent. The display name can be no longer than 30 characters.", + "description": "Required. The human-readable name of the transition route group, unique within the flow. The display name can be no longer than 30 characters.", "type": "string" }, "name": { @@ -7767,7 +7767,7 @@ "id": "GoogleCloudDialogflowCxV3WebhookRequestFulfillmentInfo", "properties": { "tag": { - "description": "Always present. The tag used to identify which fulfillment is being called.", + "description": "Always present. The value of the Fulfillment.tag field will be populated in this field by Dialogflow when the associated webhook is called. The tag is typically used by the webhook service to identify which fulfillment is being called, but it could be used for other purposes.", "type": "string" } }, @@ -8419,7 +8419,7 @@ "type": "array" }, "tag": { - "description": "The tag used by the webhook to identify which fulfillment is being called. This field is required if `webhook` is specified.", + "description": "The value of this field will be populated in the WebhookRequest `fulfillmentInfo.tag` field by Dialogflow when the associated webhook is called. The tag is typically used by the webhook service to identify which fulfillment is being called, but it could be used for other purposes. This field is required if `webhook` is specified.", "type": "string" }, "webhook": { @@ -8776,7 +8776,7 @@ "id": "GoogleCloudDialogflowCxV3beta1Page", "properties": { "displayName": { - "description": "Required. The human-readable name of the page, unique within the agent.", + "description": "Required. The human-readable name of the page, unique within the flow.", "type": "string" }, "entryFulfillment": { @@ -9474,7 +9474,7 @@ "id": "GoogleCloudDialogflowCxV3beta1WebhookRequestFulfillmentInfo", "properties": { "tag": { - "description": "Always present. The tag used to identify which fulfillment is being called.", + "description": "Always present. The value of the Fulfillment.tag field will be populated in this field by Dialogflow when the associated webhook is called. The tag is typically used by the webhook service to identify which fulfillment is being called, but it could be used for other purposes.", "type": "string" } }, diff --git a/dialogflow/v3/dialogflow-gen.go b/dialogflow/v3/dialogflow-gen.go index dff90fe6928..dbf32963c44 100644 --- a/dialogflow/v3/dialogflow-gen.go +++ b/dialogflow/v3/dialogflow-gen.go @@ -2615,7 +2615,7 @@ type GoogleCloudDialogflowCxV3Flow struct { // current page. Transition routes defined in the page have higher // priority than those defined in the flow. TransitionRoutes are // evalauted in the following order: * TransitionRoutes with intent - // specified.. * TransitionRoutes with only condition specified. + // specified. * TransitionRoutes with only condition specified. // TransitionRoutes with intent specified are inherited by pages in the // flow. TransitionRoutes []*GoogleCloudDialogflowCxV3TransitionRoute `json:"transitionRoutes,omitempty"` @@ -2958,8 +2958,11 @@ type GoogleCloudDialogflowCxV3Fulfillment struct { // webhook. SetParameterActions []*GoogleCloudDialogflowCxV3FulfillmentSetParameterAction `json:"setParameterActions,omitempty"` - // Tag: The tag used by the webhook to identify which fulfillment is - // being called. This field is required if `webhook` is specified. + // Tag: The value of this field will be populated in the WebhookRequest + // `fulfillmentInfo.tag` field by Dialogflow when the associated webhook + // is called. The tag is typically used by the webhook service to + // identify which fulfillment is being called, but it could be used for + // other purposes. This field is required if `webhook` is specified. Tag string `json:"tag,omitempty"` // Webhook: The webhook to call. Format: @@ -4892,7 +4895,7 @@ func (s *GoogleCloudDialogflowCxV3OutputAudioConfig) MarshalJSON() ([]byte, erro // (https://cloud.google.com/dialogflow/cx/docs/concept/page). type GoogleCloudDialogflowCxV3Page struct { // DisplayName: Required. The human-readable name of the page, unique - // within the agent. + // within the flow. DisplayName string `json:"displayName,omitempty"` // EntryFulfillment: The fulfillment to call when the session is @@ -7050,7 +7053,7 @@ func (s *GoogleCloudDialogflowCxV3TransitionRoute) MarshalJSON() ([]byte, error) // used by a Page. type GoogleCloudDialogflowCxV3TransitionRouteGroup struct { // DisplayName: Required. The human-readable name of the transition - // route group, unique within the Agent. The display name can be no + // route group, unique within the flow. The display name can be no // longer than 30 characters. DisplayName string `json:"displayName,omitempty"` @@ -7794,8 +7797,11 @@ func (s *GoogleCloudDialogflowCxV3WebhookRequest) MarshalJSON() ([]byte, error) // GoogleCloudDialogflowCxV3WebhookRequestFulfillmentInfo: Represents // fulfillment information communicated to the webhook. type GoogleCloudDialogflowCxV3WebhookRequestFulfillmentInfo struct { - // Tag: Always present. The tag used to identify which fulfillment is - // being called. + // Tag: Always present. The value of the Fulfillment.tag field will be + // populated in this field by Dialogflow when the associated webhook is + // called. The tag is typically used by the webhook service to identify + // which fulfillment is being called, but it could be used for other + // purposes. Tag string `json:"tag,omitempty"` // ForceSendFields is a list of field names (e.g. "Tag") to @@ -9053,8 +9059,11 @@ type GoogleCloudDialogflowCxV3beta1Fulfillment struct { // webhook. SetParameterActions []*GoogleCloudDialogflowCxV3beta1FulfillmentSetParameterAction `json:"setParameterActions,omitempty"` - // Tag: The tag used by the webhook to identify which fulfillment is - // being called. This field is required if `webhook` is specified. + // Tag: The value of this field will be populated in the WebhookRequest + // `fulfillmentInfo.tag` field by Dialogflow when the associated webhook + // is called. The tag is typically used by the webhook service to + // identify which fulfillment is being called, but it could be used for + // other purposes. This field is required if `webhook` is specified. Tag string `json:"tag,omitempty"` // Webhook: The webhook to call. Format: @@ -9787,7 +9796,7 @@ func (s *GoogleCloudDialogflowCxV3beta1IntentTrainingPhrasePart) MarshalJSON() ( // (https://cloud.google.com/dialogflow/cx/docs/concept/page). type GoogleCloudDialogflowCxV3beta1Page struct { // DisplayName: Required. The human-readable name of the page, unique - // within the agent. + // within the flow. DisplayName string `json:"displayName,omitempty"` // EntryFulfillment: The fulfillment to call when the session is @@ -11058,8 +11067,11 @@ func (s *GoogleCloudDialogflowCxV3beta1WebhookRequest) MarshalJSON() ([]byte, er // GoogleCloudDialogflowCxV3beta1WebhookRequestFulfillmentInfo: // Represents fulfillment information communicated to the webhook. type GoogleCloudDialogflowCxV3beta1WebhookRequestFulfillmentInfo struct { - // Tag: Always present. The tag used to identify which fulfillment is - // being called. + // Tag: Always present. The value of the Fulfillment.tag field will be + // populated in this field by Dialogflow when the associated webhook is + // called. The tag is typically used by the webhook service to identify + // which fulfillment is being called, but it could be used for other + // purposes. Tag string `json:"tag,omitempty"` // ForceSendFields is a list of field names (e.g. "Tag") to @@ -33944,7 +33956,7 @@ type ProjectsLocationsAgentsTestCasesImportCall struct { } // Import: Imports the test cases from a Cloud Storage bucket or a local -// file. It always creates new test cases and won't overwite any +// file. It always creates new test cases and won't overwrite any // existing ones. The provided ID in the imported test case is // neglected. This method is a long-running operation // (https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). @@ -34052,7 +34064,7 @@ func (c *ProjectsLocationsAgentsTestCasesImportCall) Do(opts ...googleapi.CallOp } return ret, nil // { - // "description": "Imports the test cases from a Cloud Storage bucket or a local file. It always creates new test cases and won't overwite any existing ones. The provided ID in the imported test case is neglected. This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: - `metadata`: ImportTestCasesMetadata - `response`: ImportTestCasesResponse", + // "description": "Imports the test cases from a Cloud Storage bucket or a local file. It always creates new test cases and won't overwrite any existing ones. The provided ID in the imported test case is neglected. This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: - `metadata`: ImportTestCasesMetadata - `response`: ImportTestCasesResponse", // "flatPath": "v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/testCases:import", // "httpMethod": "POST", // "id": "dialogflow.projects.locations.agents.testCases.import", diff --git a/dialogflow/v3beta1/dialogflow-api.json b/dialogflow/v3beta1/dialogflow-api.json index 745ca0c4c5c..445a7092b0c 100644 --- a/dialogflow/v3beta1/dialogflow-api.json +++ b/dialogflow/v3beta1/dialogflow-api.json @@ -3078,7 +3078,7 @@ ] }, "import": { - "description": "Imports the test cases from a Cloud Storage bucket or a local file. It always creates new test cases and won't overwite any existing ones. The provided ID in the imported test case is neglected. This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: - `metadata`: ImportTestCasesMetadata - `response`: ImportTestCasesResponse", + "description": "Imports the test cases from a Cloud Storage bucket or a local file. It always creates new test cases and won't overwrite any existing ones. The provided ID in the imported test case is neglected. This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: - `metadata`: ImportTestCasesMetadata - `response`: ImportTestCasesResponse", "flatPath": "v3beta1/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/testCases:import", "httpMethod": "POST", "id": "dialogflow.projects.locations.agents.testCases.import", @@ -3820,7 +3820,7 @@ } } }, - "revision": "20220404", + "revision": "20220411", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowCxV3AudioInput": { @@ -4332,7 +4332,7 @@ "type": "array" }, "tag": { - "description": "The tag used by the webhook to identify which fulfillment is being called. This field is required if `webhook` is specified.", + "description": "The value of this field will be populated in the WebhookRequest `fulfillmentInfo.tag` field by Dialogflow when the associated webhook is called. The tag is typically used by the webhook service to identify which fulfillment is being called, but it could be used for other purposes. This field is required if `webhook` is specified.", "type": "string" }, "webhook": { @@ -4689,7 +4689,7 @@ "id": "GoogleCloudDialogflowCxV3Page", "properties": { "displayName": { - "description": "Required. The human-readable name of the page, unique within the agent.", + "description": "Required. The human-readable name of the page, unique within the flow.", "type": "string" }, "entryFulfillment": { @@ -5387,7 +5387,7 @@ "id": "GoogleCloudDialogflowCxV3WebhookRequestFulfillmentInfo", "properties": { "tag": { - "description": "Always present. The tag used to identify which fulfillment is being called.", + "description": "Always present. The value of the Fulfillment.tag field will be populated in this field by Dialogflow when the associated webhook is called. The tag is typically used by the webhook service to identify which fulfillment is being called, but it could be used for other purposes.", "type": "string" } }, @@ -6728,7 +6728,7 @@ "type": "array" }, "transitionRoutes": { - "description": "A flow's transition routes serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition routes and can support use cases such as the user saying \"help\" or \"can I talk to a human?\", which can be handled in a common way regardless of the current page. Transition routes defined in the page have higher priority than those defined in the flow. TransitionRoutes are evalauted in the following order: * TransitionRoutes with intent specified.. * TransitionRoutes with only condition specified. TransitionRoutes with intent specified are inherited by pages in the flow.", + "description": "A flow's transition routes serve two purposes: * They are responsible for matching the user's first utterances in the flow. * They are inherited by every page's transition routes and can support use cases such as the user saying \"help\" or \"can I talk to a human?\", which can be handled in a common way regardless of the current page. Transition routes defined in the page have higher priority than those defined in the flow. TransitionRoutes are evalauted in the following order: * TransitionRoutes with intent specified. * TransitionRoutes with only condition specified. TransitionRoutes with intent specified are inherited by pages in the flow.", "items": { "$ref": "GoogleCloudDialogflowCxV3beta1TransitionRoute" }, @@ -6900,7 +6900,7 @@ "type": "array" }, "tag": { - "description": "The tag used by the webhook to identify which fulfillment is being called. This field is required if `webhook` is specified.", + "description": "The value of this field will be populated in the WebhookRequest `fulfillmentInfo.tag` field by Dialogflow when the associated webhook is called. The tag is typically used by the webhook service to identify which fulfillment is being called, but it could be used for other purposes. This field is required if `webhook` is specified.", "type": "string" }, "webhook": { @@ -7851,7 +7851,7 @@ "id": "GoogleCloudDialogflowCxV3beta1Page", "properties": { "displayName": { - "description": "Required. The human-readable name of the page, unique within the agent.", + "description": "Required. The human-readable name of the page, unique within the flow.", "type": "string" }, "entryFulfillment": { @@ -9014,7 +9014,7 @@ "id": "GoogleCloudDialogflowCxV3beta1TransitionRouteGroup", "properties": { "displayName": { - "description": "Required. The human-readable name of the transition route group, unique within the Agent. The display name can be no longer than 30 characters.", + "description": "Required. The human-readable name of the transition route group, unique within the flow. The display name can be no longer than 30 characters.", "type": "string" }, "name": { @@ -9459,7 +9459,7 @@ "id": "GoogleCloudDialogflowCxV3beta1WebhookRequestFulfillmentInfo", "properties": { "tag": { - "description": "Always present. The tag used to identify which fulfillment is being called.", + "description": "Always present. The value of the Fulfillment.tag field will be populated in this field by Dialogflow when the associated webhook is called. The tag is typically used by the webhook service to identify which fulfillment is being called, but it could be used for other purposes.", "type": "string" } }, diff --git a/dialogflow/v3beta1/dialogflow-gen.go b/dialogflow/v3beta1/dialogflow-gen.go index 3b4c344bd7c..da35eed9062 100644 --- a/dialogflow/v3beta1/dialogflow-gen.go +++ b/dialogflow/v3beta1/dialogflow-gen.go @@ -1389,8 +1389,11 @@ type GoogleCloudDialogflowCxV3Fulfillment struct { // webhook. SetParameterActions []*GoogleCloudDialogflowCxV3FulfillmentSetParameterAction `json:"setParameterActions,omitempty"` - // Tag: The tag used by the webhook to identify which fulfillment is - // being called. This field is required if `webhook` is specified. + // Tag: The value of this field will be populated in the WebhookRequest + // `fulfillmentInfo.tag` field by Dialogflow when the associated webhook + // is called. The tag is typically used by the webhook service to + // identify which fulfillment is being called, but it could be used for + // other purposes. This field is required if `webhook` is specified. Tag string `json:"tag,omitempty"` // Webhook: The webhook to call. Format: @@ -2121,7 +2124,7 @@ func (s *GoogleCloudDialogflowCxV3IntentTrainingPhrasePart) MarshalJSON() ([]byt // (https://cloud.google.com/dialogflow/cx/docs/concept/page). type GoogleCloudDialogflowCxV3Page struct { // DisplayName: Required. The human-readable name of the page, unique - // within the agent. + // within the flow. DisplayName string `json:"displayName,omitempty"` // EntryFulfillment: The fulfillment to call when the session is @@ -3390,8 +3393,11 @@ func (s *GoogleCloudDialogflowCxV3WebhookRequest) MarshalJSON() ([]byte, error) // GoogleCloudDialogflowCxV3WebhookRequestFulfillmentInfo: Represents // fulfillment information communicated to the webhook. type GoogleCloudDialogflowCxV3WebhookRequestFulfillmentInfo struct { - // Tag: Always present. The tag used to identify which fulfillment is - // being called. + // Tag: Always present. The value of the Fulfillment.tag field will be + // populated in this field by Dialogflow when the associated webhook is + // called. The tag is typically used by the webhook service to identify + // which fulfillment is being called, but it could be used for other + // purposes. Tag string `json:"tag,omitempty"` // ForceSendFields is a list of field names (e.g. "Tag") to @@ -5839,7 +5845,7 @@ type GoogleCloudDialogflowCxV3beta1Flow struct { // current page. Transition routes defined in the page have higher // priority than those defined in the flow. TransitionRoutes are // evalauted in the following order: * TransitionRoutes with intent - // specified.. * TransitionRoutes with only condition specified. + // specified. * TransitionRoutes with only condition specified. // TransitionRoutes with intent specified are inherited by pages in the // flow. TransitionRoutes []*GoogleCloudDialogflowCxV3beta1TransitionRoute `json:"transitionRoutes,omitempty"` @@ -6183,8 +6189,11 @@ type GoogleCloudDialogflowCxV3beta1Fulfillment struct { // webhook. SetParameterActions []*GoogleCloudDialogflowCxV3beta1FulfillmentSetParameterAction `json:"setParameterActions,omitempty"` - // Tag: The tag used by the webhook to identify which fulfillment is - // being called. This field is required if `webhook` is specified. + // Tag: The value of this field will be populated in the WebhookRequest + // `fulfillmentInfo.tag` field by Dialogflow when the associated webhook + // is called. The tag is typically used by the webhook service to + // identify which fulfillment is being called, but it could be used for + // other purposes. This field is required if `webhook` is specified. Tag string `json:"tag,omitempty"` // Webhook: The webhook to call. Format: @@ -8121,7 +8130,7 @@ func (s *GoogleCloudDialogflowCxV3beta1OutputAudioConfig) MarshalJSON() ([]byte, // (https://cloud.google.com/dialogflow/cx/docs/concept/page). type GoogleCloudDialogflowCxV3beta1Page struct { // DisplayName: Required. The human-readable name of the page, unique - // within the agent. + // within the flow. DisplayName string `json:"displayName,omitempty"` // EntryFulfillment: The fulfillment to call when the session is @@ -10281,7 +10290,7 @@ func (s *GoogleCloudDialogflowCxV3beta1TransitionRoute) MarshalJSON() ([]byte, e // used by a Page. type GoogleCloudDialogflowCxV3beta1TransitionRouteGroup struct { // DisplayName: Required. The human-readable name of the transition - // route group, unique within the Agent. The display name can be no + // route group, unique within the flow. The display name can be no // longer than 30 characters. DisplayName string `json:"displayName,omitempty"` @@ -11026,8 +11035,11 @@ func (s *GoogleCloudDialogflowCxV3beta1WebhookRequest) MarshalJSON() ([]byte, er // GoogleCloudDialogflowCxV3beta1WebhookRequestFulfillmentInfo: // Represents fulfillment information communicated to the webhook. type GoogleCloudDialogflowCxV3beta1WebhookRequestFulfillmentInfo struct { - // Tag: Always present. The tag used to identify which fulfillment is - // being called. + // Tag: Always present. The value of the Fulfillment.tag field will be + // populated in this field by Dialogflow when the associated webhook is + // called. The tag is typically used by the webhook service to identify + // which fulfillment is being called, but it could be used for other + // purposes. Tag string `json:"tag,omitempty"` // ForceSendFields is a list of field names (e.g. "Tag") to @@ -33965,7 +33977,7 @@ type ProjectsLocationsAgentsTestCasesImportCall struct { } // Import: Imports the test cases from a Cloud Storage bucket or a local -// file. It always creates new test cases and won't overwite any +// file. It always creates new test cases and won't overwrite any // existing ones. The provided ID in the imported test case is // neglected. This method is a long-running operation // (https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). @@ -34073,7 +34085,7 @@ func (c *ProjectsLocationsAgentsTestCasesImportCall) Do(opts ...googleapi.CallOp } return ret, nil // { - // "description": "Imports the test cases from a Cloud Storage bucket or a local file. It always creates new test cases and won't overwite any existing ones. The provided ID in the imported test case is neglected. This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: - `metadata`: ImportTestCasesMetadata - `response`: ImportTestCasesResponse", + // "description": "Imports the test cases from a Cloud Storage bucket or a local file. It always creates new test cases and won't overwrite any existing ones. The provided ID in the imported test case is neglected. This method is a [long-running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `Operation` type has the following method-specific fields: - `metadata`: ImportTestCasesMetadata - `response`: ImportTestCasesResponse", // "flatPath": "v3beta1/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/testCases:import", // "httpMethod": "POST", // "id": "dialogflow.projects.locations.agents.testCases.import", diff --git a/gkehub/v1beta1/gkehub-api.json b/gkehub/v1beta1/gkehub-api.json index a280e50011f..5af7c98099e 100644 --- a/gkehub/v1beta1/gkehub-api.json +++ b/gkehub/v1beta1/gkehub-api.json @@ -706,7 +706,7 @@ } } }, - "revision": "20220401", + "revision": "20220408", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AuditConfig": { @@ -792,7 +792,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,7 +1443,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\"`", @@ -1458,7 +1458,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/gkehub/v1beta1/gkehub-gen.go b/gkehub/v1beta1/gkehub-gen.go index afaddca3c25..e3ff90f580f 100644 --- a/gkehub/v1beta1/gkehub-gen.go +++ b/gkehub/v1beta1/gkehub-gen.go @@ -349,8 +349,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 @@ -1576,7 +1576,7 @@ func (s *ResourceOptions) 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"` @@ -1613,7 +1613,7 @@ func (s *SetIamPolicyRequest) 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"` diff --git a/pubsub/v1/pubsub-api.json b/pubsub/v1/pubsub-api.json index 309e6b3ba18..ade428d5b95 100644 --- a/pubsub/v1/pubsub-api.json +++ b/pubsub/v1/pubsub-api.json @@ -1424,7 +1424,7 @@ } } }, - "revision": "20220322", + "revision": "20220404", "rootUrl": "https://pubsub.googleapis.com/", "schemas": { "AcknowledgeRequest": { @@ -1450,7 +1450,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" }, @@ -1977,7 +1977,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." } }, "type": "object" @@ -2103,7 +2103,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/pubsub/v1/pubsub-gen.go b/pubsub/v1/pubsub-gen.go index e4b56536d8d..096e6ac5f5e 100644 --- a/pubsub/v1/pubsub-gen.go +++ b/pubsub/v1/pubsub-gen.go @@ -270,8 +270,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 @@ -1505,7 +1505,7 @@ type SeekResponse struct { 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"` @@ -1760,7 +1760,7 @@ func (s *Subscription) 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"` diff --git a/pubsub/v1beta2/pubsub-api.json b/pubsub/v1beta2/pubsub-api.json index f54201c6f02..1058343b189 100644 --- a/pubsub/v1beta2/pubsub-api.json +++ b/pubsub/v1beta2/pubsub-api.json @@ -724,7 +724,7 @@ } } }, - "revision": "20220322", + "revision": "20220404", "rootUrl": "https://pubsub.googleapis.com/", "schemas": { "AcknowledgeRequest": { @@ -750,7 +750,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" }, @@ -1048,7 +1048,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." } }, "type": "object" @@ -1082,7 +1082,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/pubsub/v1beta2/pubsub-gen.go b/pubsub/v1beta2/pubsub-gen.go index 7083ae366ba..e969574df07 100644 --- a/pubsub/v1beta2/pubsub-gen.go +++ b/pubsub/v1beta2/pubsub-gen.go @@ -234,8 +234,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 @@ -971,7 +971,7 @@ func (s *ReceivedMessage) 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"` @@ -1066,7 +1066,7 @@ func (s *Subscription) 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"` diff --git a/run/v1alpha1/run-api.json b/run/v1alpha1/run-api.json index d0a7bc28087..6b0be4d7101 100644 --- a/run/v1alpha1/run-api.json +++ b/run/v1alpha1/run-api.json @@ -268,7 +268,7 @@ } } }, - "revision": "20220318", + "revision": "20220408", "rootUrl": "https://run.googleapis.com/", "schemas": { "ConfigMapEnvSource": { @@ -1074,12 +1074,12 @@ "description": "(Optional) HTTPGet specifies the http request to perform. A field inlined from the Handler message." }, "initialDelaySeconds": { - "description": "(Optional) Number of seconds after the container has started before liveness probes are initiated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes", + "description": "(Optional) Number of seconds after the container has started before liveness probes are initiated. Defaults to 0 seconds. Minimum value is 0. Max value for liveness probe is 3600. Max value for startup probe is 240. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes", "format": "int32", "type": "integer" }, "periodSeconds": { - "description": "(Optional) How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1. Maximum value is 3600. Must be greater or equal than timeout_seconds.", + "description": "(Optional) How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1. Max value for liveness probe is 3600. Max value for startup probe is 240. Must be greater or equal than timeout_seconds.", "format": "int32", "type": "integer" }, diff --git a/run/v1alpha1/run-gen.go b/run/v1alpha1/run-gen.go index 06c739d4951..c201f465ca5 100644 --- a/run/v1alpha1/run-gen.go +++ b/run/v1alpha1/run-gen.go @@ -1620,13 +1620,16 @@ type Probe struct { HttpGet *HTTPGetAction `json:"httpGet,omitempty"` // InitialDelaySeconds: (Optional) Number of seconds after the container - // has started before liveness probes are initiated. More info: + // has started before liveness probes are initiated. Defaults to 0 + // seconds. Minimum value is 0. Max value for liveness probe is 3600. + // Max value for startup probe is 240. More info: // https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes InitialDelaySeconds int64 `json:"initialDelaySeconds,omitempty"` // PeriodSeconds: (Optional) How often (in seconds) to perform the - // probe. Default to 10 seconds. Minimum value is 1. Maximum value is - // 3600. Must be greater or equal than timeout_seconds. + // probe. Default to 10 seconds. Minimum value is 1. Max value for + // liveness probe is 3600. Max value for startup probe is 240. Must be + // greater or equal than timeout_seconds. PeriodSeconds int64 `json:"periodSeconds,omitempty"` // SuccessThreshold: (Optional) Minimum consecutive successes for the diff --git a/run/v2/run-api.json b/run/v2/run-api.json index 4fc3e232ba8..6a778d2b932 100644 --- a/run/v2/run-api.json +++ b/run/v2/run-api.json @@ -590,7 +590,7 @@ } } }, - "revision": "20220401", + "revision": "20220408", "rootUrl": "https://run.googleapis.com/", "schemas": { "GoogleCloudRunV2BinaryAuthorization": { @@ -616,7 +616,7 @@ "description": "Represents a specific Cloud SQL instance.", "id": "GoogleCloudRunV2CloudSqlInstance", "properties": { - "connections": { + "instances": { "description": "The Cloud SQL instance connection names, as can be found in https://console.cloud.google.com/sql/instances. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run. Format: {project}:{location}:{instance}", "items": { "type": "string" @@ -676,7 +676,7 @@ "ASSIGNING_TRAFFIC", "UPDATING_INGRESS_TRAFFIC_ALLOWED", "REVISION_ORG_POLICY_VIOLATION", - "ENABLING_GCFV2_URI_SUPPORT" + "UPDATING_GCFV2_URI_DATA" ], "enumDescriptions": [ "Default value.", @@ -686,7 +686,7 @@ "Assigning traffic; this is a transient reason.", "Updating ingress traffic settings; this is a transient reason.", "The revision can't be created because it violates an org policy setting.", - "Enabling GCFv2 URI support; this is a transient reason." + "Updating GCFv2 URI data; this is a transient reason." ], "type": "string" }, @@ -1678,7 +1678,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" }, @@ -1728,7 +1728,7 @@ "properties": { "policy": { "$ref": "GoogleIamV1Policy", - "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\"`", @@ -1743,7 +1743,7 @@ "id": "GoogleIamV1TestIamPermissionsRequest", "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/run/v2/run-gen.go b/run/v2/run-gen.go index 3c7b6616526..b7e98ab40c8 100644 --- a/run/v2/run-gen.go +++ b/run/v2/run-gen.go @@ -240,14 +240,14 @@ func (s *GoogleCloudRunV2BinaryAuthorization) MarshalJSON() ([]byte, error) { // GoogleCloudRunV2CloudSqlInstance: Represents a specific Cloud SQL // instance. type GoogleCloudRunV2CloudSqlInstance struct { - // Connections: The Cloud SQL instance connection names, as can be found + // Instances: The Cloud SQL instance connection names, as can be found // in https://console.cloud.google.com/sql/instances. Visit // https://cloud.google.com/sql/docs/mysql/connect-run for more // information on how to connect Cloud SQL and Cloud Run. Format: // {project}:{location}:{instance} - Connections []string `json:"connections,omitempty"` + Instances []string `json:"instances,omitempty"` - // ForceSendFields is a list of field names (e.g. "Connections") to + // ForceSendFields is a list of field names (e.g. "Instances") 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 @@ -255,10 +255,10 @@ type GoogleCloudRunV2CloudSqlInstance struct { // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Connections") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as + // NullFields is a list of field names (e.g. "Instances") 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:"-"` @@ -311,8 +311,8 @@ type GoogleCloudRunV2Condition struct { // settings; this is a transient reason. // "REVISION_ORG_POLICY_VIOLATION" - The revision can't be created // because it violates an org policy setting. - // "ENABLING_GCFV2_URI_SUPPORT" - Enabling GCFv2 URI support; this is - // a transient reason. + // "UPDATING_GCFV2_URI_DATA" - Updating GCFv2 URI data; this is a + // transient reason. InternalReason string `json:"internalReason,omitempty"` // LastTransitionTime: Last time the condition transitioned from one @@ -1728,8 +1728,8 @@ type GoogleIamV1Binding struct { // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *GoogleTypeExpr `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 @@ -1904,7 +1904,7 @@ func (s *GoogleIamV1Policy) MarshalJSON() ([]byte, error) { type GoogleIamV1SetIamPolicyRequest 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 *GoogleIamV1Policy `json:"policy,omitempty"` @@ -1941,7 +1941,7 @@ func (s *GoogleIamV1SetIamPolicyRequest) MarshalJSON() ([]byte, error) { // `TestIamPermissions` method. type GoogleIamV1TestIamPermissionsRequest 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"` diff --git a/servicedirectory/v1/servicedirectory-api.json b/servicedirectory/v1/servicedirectory-api.json index e056c77f559..8966175983a 100644 --- a/servicedirectory/v1/servicedirectory-api.json +++ b/servicedirectory/v1/servicedirectory-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" }, @@ -883,7 +883,7 @@ } } }, - "revision": "20220325", + "revision": "20220407", "rootUrl": "https://servicedirectory.googleapis.com/", "schemas": { "Binding": { @@ -895,7 +895,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" }, @@ -1197,7 +1197,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." } }, "type": "object" @@ -1207,7 +1207,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/servicedirectory/v1/servicedirectory-gen.go b/servicedirectory/v1/servicedirectory-gen.go index d2432c02b5d..574a6fff404 100644 --- a/servicedirectory/v1/servicedirectory-gen.go +++ b/servicedirectory/v1/servicedirectory-gen.go @@ -206,8 +206,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 @@ -971,7 +971,7 @@ func (s *Service) 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"` @@ -1002,7 +1002,7 @@ func (s *SetIamPolicyRequest) 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"` @@ -1234,8 +1234,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 @@ -1364,7 +1364,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/servicedirectory/v1beta1/servicedirectory-api.json b/servicedirectory/v1beta1/servicedirectory-api.json index 14a086c3f48..ef887a697d7 100644 --- a/servicedirectory/v1beta1/servicedirectory-api.json +++ b/servicedirectory/v1beta1/servicedirectory-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" }, @@ -883,7 +883,7 @@ } } }, - "revision": "20220325", + "revision": "20220407", "rootUrl": "https://servicedirectory.googleapis.com/", "schemas": { "Binding": { @@ -895,7 +895,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" }, @@ -1233,7 +1233,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." } }, "type": "object" @@ -1243,7 +1243,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/servicedirectory/v1beta1/servicedirectory-gen.go b/servicedirectory/v1beta1/servicedirectory-gen.go index c7c86bddfb9..9ddd2298de4 100644 --- a/servicedirectory/v1beta1/servicedirectory-gen.go +++ b/servicedirectory/v1beta1/servicedirectory-gen.go @@ -206,8 +206,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 @@ -995,7 +995,7 @@ func (s *Service) 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"` @@ -1026,7 +1026,7 @@ func (s *SetIamPolicyRequest) 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"` @@ -1258,8 +1258,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 @@ -1388,7 +1388,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/vmmigration/v1/vmmigration-api.json b/vmmigration/v1/vmmigration-api.json index 381f84b0ed4..86abe86de3e 100644 --- a/vmmigration/v1/vmmigration-api.json +++ b/vmmigration/v1/vmmigration-api.json @@ -1886,7 +1886,7 @@ } } }, - "revision": "20220401", + "revision": "20220408", "rootUrl": "https://vmmigration.googleapis.com/", "schemas": { "AddGroupMigrationRequest": { @@ -1965,6 +1965,27 @@ }, "type": "object" }, + "AwsSourceVmDetails": { + "description": "Represent the source AWS VM details.", + "id": "AwsSourceVmDetails", + "properties": { + "firmware": { + "description": "The firmware type of the source VM.", + "enum": [ + "FIRMWARE_UNSPECIFIED", + "EFI", + "BIOS" + ], + "enumDescriptions": [ + "The firmware is unknown.", + "The firmware is EFI.", + "The firmware is BIOS." + ], + "type": "string" + } + }, + "type": "object" + }, "CancelCloneJobRequest": { "description": "Request message for 'CancelCloneJob' request.", "id": "CancelCloneJobRequest", @@ -2897,6 +2918,11 @@ "description": "MigratingVm describes the VM that will be migrated from a Source environment and its replication state.", "id": "MigratingVm", "properties": { + "awsSourceVmDetails": { + "$ref": "AwsSourceVmDetails", + "description": "Output only. Details of the VM from an AWS source.", + "readOnly": true + }, "computeEngineTargetDefaults": { "$ref": "ComputeEngineTargetDefaults", "description": "Details of the target VM in Compute Engine." diff --git a/vmmigration/v1/vmmigration-gen.go b/vmmigration/v1/vmmigration-gen.go index 6fa554fa47c..1065c5d7e68 100644 --- a/vmmigration/v1/vmmigration-gen.go +++ b/vmmigration/v1/vmmigration-gen.go @@ -408,6 +408,39 @@ func (s *AvailableUpdates) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// AwsSourceVmDetails: Represent the source AWS VM details. +type AwsSourceVmDetails struct { + // Firmware: The firmware type of the source VM. + // + // Possible values: + // "FIRMWARE_UNSPECIFIED" - The firmware is unknown. + // "EFI" - The firmware is EFI. + // "BIOS" - The firmware is BIOS. + Firmware string `json:"firmware,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Firmware") 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. "Firmware") 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 *AwsSourceVmDetails) MarshalJSON() ([]byte, error) { + type NoMethod AwsSourceVmDetails + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // CancelCloneJobRequest: Request message for 'CancelCloneJob' request. type CancelCloneJobRequest struct { } @@ -1572,6 +1605,10 @@ func (s *Location) MarshalJSON() ([]byte, error) { // MigratingVm: MigratingVm describes the VM that will be migrated from // a Source environment and its replication state. type MigratingVm struct { + // AwsSourceVmDetails: Output only. Details of the VM from an AWS + // source. + AwsSourceVmDetails *AwsSourceVmDetails `json:"awsSourceVmDetails,omitempty"` + // ComputeEngineTargetDefaults: Details of the target VM in Compute // Engine. ComputeEngineTargetDefaults *ComputeEngineTargetDefaults `json:"computeEngineTargetDefaults,omitempty"` @@ -1673,22 +1710,21 @@ type MigratingVm struct { // server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. - // "ComputeEngineTargetDefaults") 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 is a list of field names (e.g. "AwsSourceVmDetails") + // 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. - // "ComputeEngineTargetDefaults") 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 is a list of field names (e.g. "AwsSourceVmDetails") 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:"-"` } diff --git a/vmmigration/v1alpha1/vmmigration-api.json b/vmmigration/v1alpha1/vmmigration-api.json index 430dac77067..9ea40864ac6 100644 --- a/vmmigration/v1alpha1/vmmigration-api.json +++ b/vmmigration/v1alpha1/vmmigration-api.json @@ -1886,7 +1886,7 @@ } } }, - "revision": "20220401", + "revision": "20220408", "rootUrl": "https://vmmigration.googleapis.com/", "schemas": { "AddGroupMigrationRequest": { @@ -1965,6 +1965,27 @@ }, "type": "object" }, + "AwsSourceVmDetails": { + "description": "Represent the source AWS VM details.", + "id": "AwsSourceVmDetails", + "properties": { + "firmware": { + "description": "The firmware type of the source VM.", + "enum": [ + "FIRMWARE_UNSPECIFIED", + "EFI", + "BIOS" + ], + "enumDescriptions": [ + "The firmware is unknown.", + "The firmware is EFI.", + "The firmware is BIOS." + ], + "type": "string" + } + }, + "type": "object" + }, "CancelCloneJobRequest": { "description": "Request message for 'CancelCloneJob' request.", "id": "CancelCloneJobRequest", @@ -2949,6 +2970,11 @@ "description": "MigratingVm describes the VM that will be migrated from a Source environment and its replication state.", "id": "MigratingVm", "properties": { + "awsSourceVmDetails": { + "$ref": "AwsSourceVmDetails", + "description": "Output only. Details of the VM from an AWS source.", + "readOnly": true + }, "computeEngineTargetDefaults": { "$ref": "ComputeEngineTargetDefaults", "description": "Details of the target VM in Compute Engine." diff --git a/vmmigration/v1alpha1/vmmigration-gen.go b/vmmigration/v1alpha1/vmmigration-gen.go index 181777801ca..ab22db71303 100644 --- a/vmmigration/v1alpha1/vmmigration-gen.go +++ b/vmmigration/v1alpha1/vmmigration-gen.go @@ -408,6 +408,39 @@ func (s *AvailableUpdates) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// AwsSourceVmDetails: Represent the source AWS VM details. +type AwsSourceVmDetails struct { + // Firmware: The firmware type of the source VM. + // + // Possible values: + // "FIRMWARE_UNSPECIFIED" - The firmware is unknown. + // "EFI" - The firmware is EFI. + // "BIOS" - The firmware is BIOS. + Firmware string `json:"firmware,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Firmware") 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. "Firmware") 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 *AwsSourceVmDetails) MarshalJSON() ([]byte, error) { + type NoMethod AwsSourceVmDetails + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // CancelCloneJobRequest: Request message for 'CancelCloneJob' request. type CancelCloneJobRequest struct { } @@ -1636,6 +1669,10 @@ func (s *Location) MarshalJSON() ([]byte, error) { // MigratingVm: MigratingVm describes the VM that will be migrated from // a Source environment and its replication state. type MigratingVm struct { + // AwsSourceVmDetails: Output only. Details of the VM from an AWS + // source. + AwsSourceVmDetails *AwsSourceVmDetails `json:"awsSourceVmDetails,omitempty"` + // ComputeEngineTargetDefaults: Details of the target VM in Compute // Engine. ComputeEngineTargetDefaults *ComputeEngineTargetDefaults `json:"computeEngineTargetDefaults,omitempty"` @@ -1746,22 +1783,21 @@ type MigratingVm struct { // server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. - // "ComputeEngineTargetDefaults") 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 is a list of field names (e.g. "AwsSourceVmDetails") + // 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. - // "ComputeEngineTargetDefaults") 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 is a list of field names (e.g. "AwsSourceVmDetails") 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:"-"` } diff --git a/workflows/v1beta/workflows-api.json b/workflows/v1beta/workflows-api.json index e2d2b843c4f..90574c3d507 100644 --- a/workflows/v1beta/workflows-api.json +++ b/workflows/v1beta/workflows-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" }, @@ -444,7 +444,7 @@ } } }, - "revision": "20220323", + "revision": "20220406", "rootUrl": "https://workflows.googleapis.com/", "schemas": { "Empty": { diff --git a/workflows/v1beta/workflows-gen.go b/workflows/v1beta/workflows-gen.go index 77c28d37d07..21223a777df 100644 --- a/workflows/v1beta/workflows-gen.go +++ b/workflows/v1beta/workflows-gen.go @@ -761,8 +761,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 @@ -891,7 +891,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" // }, From 11035bd36009ca49a6724520162d47ce6ff264fc Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Mon, 18 Apr 2022 07:38:32 -0700 Subject: [PATCH 13/17] feat(all): auto-regenerate discovery clients (#1514) --- apigateway/v1/apigateway-api.json | 10 +- apigateway/v1/apigateway-gen.go | 14 +- .../v2/baremetalsolution-api.json | 136 +++++++- baremetalsolution/v2/baremetalsolution-gen.go | 323 +++++++++++++++++- .../v1/certificatemanager-api.json | 24 +- .../v1/certificatemanager-gen.go | 49 ++- datastream/v1/datastream-api.json | 18 +- datastream/v1/datastream-gen.go | 16 +- datastream/v1alpha1/datastream-api.json | 18 +- datastream/v1alpha1/datastream-gen.go | 16 +- eventarc/v1/eventarc-api.json | 8 +- eventarc/v1/eventarc-gen.go | 8 +- gkehub/v1alpha/gkehub-api.json | 28 +- gkehub/v1alpha/gkehub-gen.go | 26 +- gkehub/v1alpha2/gkehub-api.json | 8 +- gkehub/v1alpha2/gkehub-gen.go | 8 +- gkehub/v1beta/gkehub-api.json | 102 +++++- gkehub/v1beta/gkehub-gen.go | 163 ++++++++- metastore/v1alpha/metastore-api.json | 8 +- metastore/v1alpha/metastore-gen.go | 10 +- metastore/v1beta/metastore-api.json | 8 +- metastore/v1beta/metastore-gen.go | 10 +- notebooks/v1/notebooks-api.json | 28 +- notebooks/v1/notebooks-gen.go | 17 +- tpu/v1alpha1/tpu-api.json | 6 +- tpu/v1alpha1/tpu-gen.go | 9 +- tpu/v2alpha1/tpu-api.json | 8 +- tpu/v2alpha1/tpu-gen.go | 13 +- workflows/v1/workflows-api.json | 4 +- workflows/v1/workflows-gen.go | 6 +- 30 files changed, 954 insertions(+), 148 deletions(-) diff --git a/apigateway/v1/apigateway-api.json b/apigateway/v1/apigateway-api.json index 6beccd6708e..36f8271306c 100644 --- a/apigateway/v1/apigateway-api.json +++ b/apigateway/v1/apigateway-api.json @@ -143,7 +143,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" }, @@ -1083,7 +1083,7 @@ } } }, - "revision": "20220323", + "revision": "20220406", "rootUrl": "https://apigateway.googleapis.com/", "schemas": { "ApigatewayApi": { @@ -1336,7 +1336,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" }, @@ -1727,7 +1727,7 @@ "properties": { "policy": { "$ref": "ApigatewayPolicy", - "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\"`", @@ -1769,7 +1769,7 @@ "id": "ApigatewayTestIamPermissionsRequest", "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/apigateway/v1/apigateway-gen.go b/apigateway/v1/apigateway-gen.go index 258ad611ac9..6429c7d88cd 100644 --- a/apigateway/v1/apigateway-gen.go +++ b/apigateway/v1/apigateway-gen.go @@ -578,8 +578,8 @@ type ApigatewayBinding struct { // (https://cloud.google.com/iam/help/conditions/resource-policies). Condition *ApigatewayExpr `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 @@ -1281,7 +1281,7 @@ func (s *ApigatewayPolicy) MarshalJSON() ([]byte, error) { type ApigatewaySetIamPolicyRequest 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 *ApigatewayPolicy `json:"policy,omitempty"` @@ -1362,7 +1362,7 @@ func (s *ApigatewayStatus) MarshalJSON() ([]byte, error) { // `TestIamPermissions` method. type ApigatewayTestIamPermissionsRequest 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"` @@ -1605,8 +1605,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 @@ -1735,7 +1735,7 @@ func (c *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*Apigatewa // ], // "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/baremetalsolution/v2/baremetalsolution-api.json b/baremetalsolution/v2/baremetalsolution-api.json index 639314d4538..806f1a46461 100644 --- a/baremetalsolution/v2/baremetalsolution-api.json +++ b/baremetalsolution/v2/baremetalsolution-api.json @@ -143,7 +143,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" }, @@ -176,6 +176,35 @@ } }, "resources": { + "instanceProvisioningSettings": { + "methods": { + "fetch": { + "description": "Get instance provisioning settings for a given project. This is hidden method used by UI only.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/instanceProvisioningSettings:fetch", + "httpMethod": "GET", + "id": "baremetalsolution.projects.locations.instanceProvisioningSettings.fetch", + "parameterOrder": [ + "location" + ], + "parameters": { + "location": { + "description": "Required. The parent project and location containing the ProvisioningSettings.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+location}/instanceProvisioningSettings:fetch", + "response": { + "$ref": "FetchInstanceProvisioningSettingsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } + }, "instances": { "methods": { "get": { @@ -1222,7 +1251,7 @@ } } }, - "revision": "20220322", + "revision": "20220405", "rootUrl": "https://baremetalsolution.googleapis.com/", "schemas": { "AllowedClient": { @@ -1276,6 +1305,20 @@ "properties": {}, "type": "object" }, + "FetchInstanceProvisioningSettingsResponse": { + "description": "Response with all provisioning settings.", + "id": "FetchInstanceProvisioningSettingsResponse", + "properties": { + "images": { + "description": "The OS images available.", + "items": { + "$ref": "OSImage" + }, + "type": "array" + } + }, + "type": "object" + }, "Instance": { "description": "A server.", "id": "Instance", @@ -1689,6 +1732,35 @@ }, "type": "object" }, + "LogicalInterface": { + "description": "Logical interface.", + "id": "LogicalInterface", + "properties": { + "name": { + "description": "Interface name. This is not a globally unique identifier. Name is unique only inside the ServerNetworkTemplate.", + "type": "string" + }, + "required": { + "description": "If true, interface must have network connected.", + "type": "boolean" + }, + "type": { + "description": "Interface type.", + "enum": [ + "INTERFACE_TYPE_UNSPECIFIED", + "BOND", + "NIC" + ], + "enumDescriptions": [ + "Unspecified value.", + "Bond interface type.", + "NIC interface ytpe." + ], + "type": "string" + } + }, + "type": "object" + }, "Lun": { "description": "A storage volume logical unit number (LUN).", "id": "Lun", @@ -2083,6 +2155,40 @@ }, "type": "object" }, + "OSImage": { + "description": "Operation System image.", + "id": "OSImage", + "properties": { + "applicableInstanceTypes": { + "description": "Instance types this image is applicable to. [Available types](https://cloud.google.com/bare-metal/docs/bms-planning#server_configurations)", + "items": { + "type": "string" + }, + "type": "array" + }, + "code": { + "description": "OS Image code.", + "type": "string" + }, + "description": { + "description": "OS Image description.", + "type": "string" + }, + "name": { + "description": "Output only. OS Image's unique name.", + "readOnly": true, + "type": "string" + }, + "supportedNetworkTemplates": { + "description": "Network templates that can be used with this OS Image.", + "items": { + "$ref": "ServerNetworkTemplate" + }, + "type": "array" + } + }, + "type": "object" + }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", @@ -2297,6 +2403,32 @@ }, "type": "object" }, + "ServerNetworkTemplate": { + "description": "Network template.", + "id": "ServerNetworkTemplate", + "properties": { + "applicableInstanceTypes": { + "description": "Instance types this template is applicable to.", + "items": { + "type": "string" + }, + "type": "array" + }, + "logicalInterfaces": { + "description": "Logical interfaces.", + "items": { + "$ref": "LogicalInterface" + }, + "type": "array" + }, + "name": { + "description": "Output only. Template's unique name.", + "readOnly": true, + "type": "string" + } + }, + "type": "object" + }, "SnapshotReservationDetail": { "description": "Details about snapshot space reservation and usage on the storage volume.", "id": "SnapshotReservationDetail", diff --git a/baremetalsolution/v2/baremetalsolution-gen.go b/baremetalsolution/v2/baremetalsolution-gen.go index b2f4910c462..2beb95ecb52 100644 --- a/baremetalsolution/v2/baremetalsolution-gen.go +++ b/baremetalsolution/v2/baremetalsolution-gen.go @@ -151,6 +151,7 @@ type ProjectsService struct { func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { rs := &ProjectsLocationsService{s: s} + rs.InstanceProvisioningSettings = NewProjectsLocationsInstanceProvisioningSettingsService(s) rs.Instances = NewProjectsLocationsInstancesService(s) rs.Networks = NewProjectsLocationsNetworksService(s) rs.NfsShares = NewProjectsLocationsNfsSharesService(s) @@ -164,6 +165,8 @@ func NewProjectsLocationsService(s *Service) *ProjectsLocationsService { type ProjectsLocationsService struct { s *Service + InstanceProvisioningSettings *ProjectsLocationsInstanceProvisioningSettingsService + Instances *ProjectsLocationsInstancesService Networks *ProjectsLocationsNetworksService @@ -179,6 +182,15 @@ type ProjectsLocationsService struct { Volumes *ProjectsLocationsVolumesService } +func NewProjectsLocationsInstanceProvisioningSettingsService(s *Service) *ProjectsLocationsInstanceProvisioningSettingsService { + rs := &ProjectsLocationsInstanceProvisioningSettingsService{s: s} + return rs +} + +type ProjectsLocationsInstanceProvisioningSettingsService struct { + s *Service +} + func NewProjectsLocationsInstancesService(s *Service) *ProjectsLocationsInstancesService { rs := &ProjectsLocationsInstancesService{s: s} return rs @@ -332,6 +344,39 @@ type Empty struct { googleapi.ServerResponse `json:"-"` } +// FetchInstanceProvisioningSettingsResponse: Response with all +// provisioning settings. +type FetchInstanceProvisioningSettingsResponse struct { + // Images: The OS images available. + Images []*OSImage `json:"images,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Images") 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. "Images") 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 *FetchInstanceProvisioningSettingsResponse) MarshalJSON() ([]byte, error) { + type NoMethod FetchInstanceProvisioningSettingsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Instance: A server. type Instance struct { // CreateTime: Output only. Create a time stamp. @@ -966,6 +1011,46 @@ func (s *Location) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// LogicalInterface: Logical interface. +type LogicalInterface struct { + // Name: Interface name. This is not a globally unique identifier. Name + // is unique only inside the ServerNetworkTemplate. + Name string `json:"name,omitempty"` + + // Required: If true, interface must have network connected. + Required bool `json:"required,omitempty"` + + // Type: Interface type. + // + // Possible values: + // "INTERFACE_TYPE_UNSPECIFIED" - Unspecified value. + // "BOND" - Bond interface type. + // "NIC" - NIC interface ytpe. + Type string `json:"type,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Name") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. 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. "Name") 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 *LogicalInterface) MarshalJSON() ([]byte, error) { + type NoMethod LogicalInterface + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Lun: A storage volume logical unit number (LUN). type Lun struct { // BootLun: Display if this LUN is a boot LUN. @@ -1407,6 +1492,51 @@ func (s *NfsShare) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// OSImage: Operation System image. +type OSImage struct { + // ApplicableInstanceTypes: Instance types this image is applicable to. + // Available types + // (https://cloud.google.com/bare-metal/docs/bms-planning#server_configurations) + ApplicableInstanceTypes []string `json:"applicableInstanceTypes,omitempty"` + + // Code: OS Image code. + Code string `json:"code,omitempty"` + + // Description: OS Image description. + Description string `json:"description,omitempty"` + + // Name: Output only. OS Image's unique name. + Name string `json:"name,omitempty"` + + // SupportedNetworkTemplates: Network templates that can be used with + // this OS Image. + SupportedNetworkTemplates []*ServerNetworkTemplate `json:"supportedNetworkTemplates,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "ApplicableInstanceTypes") 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. "ApplicableInstanceTypes") + // 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 *OSImage) MarshalJSON() ([]byte, error) { + type NoMethod OSImage + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // Operation: This resource represents a long-running operation that is // the result of a network API call. type Operation struct { @@ -1687,6 +1817,43 @@ func (s *Schedule) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ServerNetworkTemplate: Network template. +type ServerNetworkTemplate struct { + // ApplicableInstanceTypes: Instance types this template is applicable + // to. + ApplicableInstanceTypes []string `json:"applicableInstanceTypes,omitempty"` + + // LogicalInterfaces: Logical interfaces. + LogicalInterfaces []*LogicalInterface `json:"logicalInterfaces,omitempty"` + + // Name: Output only. Template's unique name. + Name string `json:"name,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "ApplicableInstanceTypes") 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. "ApplicableInstanceTypes") + // 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 *ServerNetworkTemplate) MarshalJSON() ([]byte, error) { + type NoMethod ServerNetworkTemplate + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // SnapshotReservationDetail: Details about snapshot space reservation // and usage on the storage volume. type SnapshotReservationDetail struct { @@ -2372,8 +2539,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 @@ -2502,7 +2669,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" // }, @@ -2557,6 +2724,156 @@ func (c *ProjectsLocationsListCall) Pages(ctx context.Context, f func(*ListLocat } } +// method id "baremetalsolution.projects.locations.instanceProvisioningSettings.fetch": + +type ProjectsLocationsInstanceProvisioningSettingsFetchCall struct { + s *Service + location string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Fetch: Get instance provisioning settings for a given project. This +// is hidden method used by UI only. +// +// - location: The parent project and location containing the +// ProvisioningSettings. +func (r *ProjectsLocationsInstanceProvisioningSettingsService) Fetch(location string) *ProjectsLocationsInstanceProvisioningSettingsFetchCall { + c := &ProjectsLocationsInstanceProvisioningSettingsFetchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.location = location + 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 *ProjectsLocationsInstanceProvisioningSettingsFetchCall) Fields(s ...googleapi.Field) *ProjectsLocationsInstanceProvisioningSettingsFetchCall { + 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 *ProjectsLocationsInstanceProvisioningSettingsFetchCall) IfNoneMatch(entityTag string) *ProjectsLocationsInstanceProvisioningSettingsFetchCall { + 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 *ProjectsLocationsInstanceProvisioningSettingsFetchCall) Context(ctx context.Context) *ProjectsLocationsInstanceProvisioningSettingsFetchCall { + 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 *ProjectsLocationsInstanceProvisioningSettingsFetchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *ProjectsLocationsInstanceProvisioningSettingsFetchCall) 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/{+location}/instanceProvisioningSettings:fetch") + 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{ + "location": c.location, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "baremetalsolution.projects.locations.instanceProvisioningSettings.fetch" call. +// Exactly one of *FetchInstanceProvisioningSettingsResponse or error +// will be non-nil. Any non-2xx status code is an error. Response +// headers are in either +// *FetchInstanceProvisioningSettingsResponse.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 *ProjectsLocationsInstanceProvisioningSettingsFetchCall) Do(opts ...googleapi.CallOption) (*FetchInstanceProvisioningSettingsResponse, 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 := &FetchInstanceProvisioningSettingsResponse{ + 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": "Get instance provisioning settings for a given project. This is hidden method used by UI only.", + // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/instanceProvisioningSettings:fetch", + // "httpMethod": "GET", + // "id": "baremetalsolution.projects.locations.instanceProvisioningSettings.fetch", + // "parameterOrder": [ + // "location" + // ], + // "parameters": { + // "location": { + // "description": "Required. The parent project and location containing the ProvisioningSettings.", + // "location": "path", + // "pattern": "^projects/[^/]+/locations/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v2/{+location}/instanceProvisioningSettings:fetch", + // "response": { + // "$ref": "FetchInstanceProvisioningSettingsResponse" + // }, + // "scopes": [ + // "https://www.googleapis.com/auth/cloud-platform" + // ] + // } + +} + // method id "baremetalsolution.projects.locations.instances.get": type ProjectsLocationsInstancesGetCall struct { diff --git a/certificatemanager/v1/certificatemanager-api.json b/certificatemanager/v1/certificatemanager-api.json index 6503126d102..41c4e7e6d13 100644 --- a/certificatemanager/v1/certificatemanager-api.json +++ b/certificatemanager/v1/certificatemanager-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" }, @@ -975,7 +975,7 @@ } } }, - "revision": "20220324", + "revision": "20220407", "rootUrl": "https://certificatemanager.googleapis.com/", "schemas": { "AuthorizationAttemptInfo": { @@ -1648,6 +1648,26 @@ }, "type": "object" }, + "ResourcesCount": { + "id": "ResourcesCount", + "properties": { + "certificates": { + "description": "The count of certificates.", + "format": "uint64", + "type": "string" + }, + "computeTime": { + "description": "Required. Input only. The time of the computation. The field is input only, used in Create and Update calls. For Update call, new values of selected resources are set if their compute_time is younger than the persisted ones, e.g.: If you support 3 types of resources: A, B and C, and you have: 'A' resource count computed at timestamp = 3 'B' resource count computed at timestamp = 10 'C' resource count computed at timestamp = 5 And you're going to update all of them with compute_time = 8, only 'A' and 'C' will be updated, as 'B' already has fresher data. For Get call a ResourcesCount instance contains the freshest values for every type.", + "format": "google-datetime", + "type": "string" + }, + "name": { + "description": "The singleton resource of the resources count. Must be in the format `projects/*/locations/*/resourcesCounts/single`.", + "type": "string" + } + }, + "type": "object" + }, "SelfManagedCertificate": { "description": "Certificate data for a SelfManaged Certificate. SelfManaged Certificates are uploaded by the user. Updating such certificates before they expire remains the user's responsibility.", "id": "SelfManagedCertificate", diff --git a/certificatemanager/v1/certificatemanager-gen.go b/certificatemanager/v1/certificatemanager-gen.go index 431c2543e33..4ce3b45819e 100644 --- a/certificatemanager/v1/certificatemanager-gen.go +++ b/certificatemanager/v1/certificatemanager-gen.go @@ -1181,6 +1181,49 @@ func (s *ProvisioningIssue) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +type ResourcesCount struct { + // Certificates: The count of certificates. + Certificates uint64 `json:"certificates,omitempty,string"` + + // ComputeTime: Required. Input only. The time of the computation. The + // field is input only, used in Create and Update calls. For Update + // call, new values of selected resources are set if their compute_time + // is younger than the persisted ones, e.g.: If you support 3 types of + // resources: A, B and C, and you have: 'A' resource count computed at + // timestamp = 3 'B' resource count computed at timestamp = 10 'C' + // resource count computed at timestamp = 5 And you're going to update + // all of them with compute_time = 8, only 'A' and 'C' will be updated, + // as 'B' already has fresher data. For Get call a ResourcesCount + // instance contains the freshest values for every type. + ComputeTime string `json:"computeTime,omitempty"` + + // Name: The singleton resource of the resources count. Must be in the + // format `projects/*/locations/*/resourcesCounts/single`. + Name string `json:"name,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Certificates") 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. "Certificates") 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 *ResourcesCount) MarshalJSON() ([]byte, error) { + type NoMethod ResourcesCount + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // SelfManagedCertificate: Certificate data for a SelfManaged // Certificate. SelfManaged Certificates are uploaded by the user. // Updating such certificates before they expire remains the user's @@ -1432,8 +1475,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 @@ -1562,7 +1605,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/datastream/v1/datastream-api.json b/datastream/v1/datastream-api.json index 5c3c6d83938..d04a90ffd6b 100644 --- a/datastream/v1/datastream-api.json +++ b/datastream/v1/datastream-api.json @@ -180,7 +180,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" }, @@ -1217,7 +1217,7 @@ } } }, - "revision": "20220322", + "revision": "20220405", "rootUrl": "https://datastream.googleapis.com/", "schemas": { "AvroFileFormat": { @@ -1439,6 +1439,12 @@ }, "type": "object" }, + "DropLargeObjects": { + "description": "Configuration to drop large object values.", + "id": "DropLargeObjects", + "properties": {}, + "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", @@ -2110,12 +2116,6 @@ }, "type": "object" }, - "OracleDropLargeObjects": { - "description": "Configuration to drop large object values.", - "id": "OracleDropLargeObjects", - "properties": {}, - "type": "object" - }, "OracleObjectIdentifier": { "description": "Oracle data source object identifier.", "id": "OracleObjectIdentifier", @@ -2203,7 +2203,7 @@ "id": "OracleSourceConfig", "properties": { "dropLargeObjects": { - "$ref": "OracleDropLargeObjects", + "$ref": "DropLargeObjects", "description": "Drop large object values." }, "excludeObjects": { diff --git a/datastream/v1/datastream-gen.go b/datastream/v1/datastream-gen.go index ed2f9bc91ee..79fb54864fc 100644 --- a/datastream/v1/datastream-gen.go +++ b/datastream/v1/datastream-gen.go @@ -523,6 +523,10 @@ func (s *DiscoverConnectionProfileResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// DropLargeObjects: Configuration to drop large object values. +type DropLargeObjects struct { +} + // 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 @@ -1588,10 +1592,6 @@ func (s *OracleColumn) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// OracleDropLargeObjects: Configuration to drop large object values. -type OracleDropLargeObjects struct { -} - // OracleObjectIdentifier: Oracle data source object identifier. type OracleObjectIdentifier struct { // Schema: Required. The schema name. @@ -1730,7 +1730,7 @@ func (s *OracleSchema) MarshalJSON() ([]byte, error) { // OracleSourceConfig: Oracle data source configuration type OracleSourceConfig struct { // DropLargeObjects: Drop large object values. - DropLargeObjects *OracleDropLargeObjects `json:"dropLargeObjects,omitempty"` + DropLargeObjects *DropLargeObjects `json:"dropLargeObjects,omitempty"` // ExcludeObjects: Oracle objects to exclude from the stream. ExcludeObjects *OracleRdbms `json:"excludeObjects,omitempty"` @@ -2788,8 +2788,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 @@ -2918,7 +2918,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/datastream/v1alpha1/datastream-api.json b/datastream/v1alpha1/datastream-api.json index 509e171bcb1..3f4652bf9d1 100644 --- a/datastream/v1alpha1/datastream-api.json +++ b/datastream/v1alpha1/datastream-api.json @@ -180,7 +180,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" }, @@ -1196,7 +1196,7 @@ } } }, - "revision": "20220322", + "revision": "20220405", "rootUrl": "https://datastream.googleapis.com/", "schemas": { "AvroFileFormat": { @@ -1420,6 +1420,12 @@ }, "type": "object" }, + "DropLargeObjects": { + "description": "Configuration to drop large object values.", + "id": "DropLargeObjects", + "properties": {}, + "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", @@ -2115,12 +2121,6 @@ }, "type": "object" }, - "OracleDropLargeObjects": { - "description": "Configuration to drop large object values.", - "id": "OracleDropLargeObjects", - "properties": {}, - "type": "object" - }, "OracleObjectIdentifier": { "description": "Oracle data source object identifier.", "id": "OracleObjectIdentifier", @@ -2212,7 +2212,7 @@ "description": "Oracle objects to include in the stream." }, "dropLargeObjects": { - "$ref": "OracleDropLargeObjects", + "$ref": "DropLargeObjects", "description": "Drop large object values." }, "rejectlist": { diff --git a/datastream/v1alpha1/datastream-gen.go b/datastream/v1alpha1/datastream-gen.go index 75b32c65ace..333584a3957 100644 --- a/datastream/v1alpha1/datastream-gen.go +++ b/datastream/v1alpha1/datastream-gen.go @@ -521,6 +521,10 @@ func (s *DiscoverConnectionProfileResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// DropLargeObjects: Configuration to drop large object values. +type DropLargeObjects struct { +} + // 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 @@ -1594,10 +1598,6 @@ func (s *OracleColumn) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// OracleDropLargeObjects: Configuration to drop large object values. -type OracleDropLargeObjects struct { -} - // OracleObjectIdentifier: Oracle data source object identifier. type OracleObjectIdentifier struct { // Schema: Required. The schema name. @@ -1739,7 +1739,7 @@ type OracleSourceConfig struct { Allowlist *OracleRdbms `json:"allowlist,omitempty"` // DropLargeObjects: Drop large object values. - DropLargeObjects *OracleDropLargeObjects `json:"dropLargeObjects,omitempty"` + DropLargeObjects *DropLargeObjects `json:"dropLargeObjects,omitempty"` // Rejectlist: Oracle objects to exclude from the stream. Rejectlist *OracleRdbms `json:"rejectlist,omitempty"` @@ -2776,8 +2776,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 @@ -2906,7 +2906,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/eventarc/v1/eventarc-api.json b/eventarc/v1/eventarc-api.json index c3efdaf6028..88a25e7f4eb 100644 --- a/eventarc/v1/eventarc-api.json +++ b/eventarc/v1/eventarc-api.json @@ -846,7 +846,7 @@ } } }, - "revision": "20220331", + "revision": "20220408", "rootUrl": "https://eventarc.googleapis.com/", "schemas": { "AuditConfig": { @@ -906,7 +906,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" }, @@ -1403,7 +1403,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\"`", @@ -1418,7 +1418,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/eventarc/v1/eventarc-gen.go b/eventarc/v1/eventarc-gen.go index 3c4c5d28e1f..b8adf7502d6 100644 --- a/eventarc/v1/eventarc-gen.go +++ b/eventarc/v1/eventarc-gen.go @@ -327,8 +327,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 @@ -1285,7 +1285,7 @@ func (s *Pubsub) 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"` @@ -1322,7 +1322,7 @@ func (s *SetIamPolicyRequest) 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"` diff --git a/gkehub/v1alpha/gkehub-api.json b/gkehub/v1alpha/gkehub-api.json index 5ab1fd82a27..c5ebfff2b40 100644 --- a/gkehub/v1alpha/gkehub-api.json +++ b/gkehub/v1alpha/gkehub-api.json @@ -1139,7 +1139,7 @@ } } }, - "revision": "20220401", + "revision": "20220408", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AnthosObservabilityFeatureSpec": { @@ -1272,7 +1272,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" }, @@ -3495,6 +3495,22 @@ "User will manually configure the control plane (e.g. via CLI, or via the ControlPlaneRevision KRM API)" ], "type": "string" + }, + "defaultChannel": { + "description": "Determines which release channel to use for default injection and service mesh APIs.", + "enum": [ + "CHANNEL_UNSPECIFIED", + "RAPID", + "REGULAR", + "STABLE" + ], + "enumDescriptions": [ + "Unspecified", + "RAPID channel is offered on an early access basis for customers who want to test new releases.", + "REGULAR channel is intended for production users who want to take advantage of new features.", + "STABLE channel includes versions that are known to be stable and reliable in production." + ], + "type": "string" } }, "type": "object" @@ -3511,6 +3527,10 @@ "readOnly": true, "type": "array" }, + "configApiVersion": { + "description": "The API version (i.e. Istio CRD version) for configuring service mesh in this cluster. This version is influenced by the `default_channel` field.", + "type": "string" + }, "controlPlaneManagement": { "$ref": "ServiceMeshControlPlaneManagement", "description": "Output only. Status of control plane management", @@ -3555,7 +3575,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\"`", @@ -3597,7 +3617,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/gkehub/v1alpha/gkehub-gen.go b/gkehub/v1alpha/gkehub-gen.go index e570f555777..fa2a4a1e582 100644 --- a/gkehub/v1alpha/gkehub-gen.go +++ b/gkehub/v1alpha/gkehub-gen.go @@ -516,8 +516,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 @@ -4149,6 +4149,19 @@ type ServiceMeshMembershipSpec struct { // CLI, or via the ControlPlaneRevision KRM API) ControlPlane string `json:"controlPlane,omitempty"` + // DefaultChannel: Determines which release channel to use for default + // injection and service mesh APIs. + // + // Possible values: + // "CHANNEL_UNSPECIFIED" - Unspecified + // "RAPID" - RAPID channel is offered on an early access basis for + // customers who want to test new releases. + // "REGULAR" - REGULAR channel is intended for production users who + // want to take advantage of new features. + // "STABLE" - STABLE channel includes versions that are known to be + // stable and reliable in production. + DefaultChannel string `json:"defaultChannel,omitempty"` + // ForceSendFields is a list of field names (e.g. "ControlPlane") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any @@ -4179,6 +4192,11 @@ type ServiceMeshMembershipState struct { // analyzers. AnalysisMessages []*ServiceMeshAnalysisMessage `json:"analysisMessages,omitempty"` + // ConfigApiVersion: The API version (i.e. Istio CRD version) for + // configuring service mesh in this cluster. This version is influenced + // by the `default_channel` field. + ConfigApiVersion string `json:"configApiVersion,omitempty"` + // ControlPlaneManagement: Output only. Status of control plane // management ControlPlaneManagement *ServiceMeshControlPlaneManagement `json:"controlPlaneManagement,omitempty"` @@ -4284,7 +4302,7 @@ func (s *ServiceMeshType) 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"` @@ -4364,7 +4382,7 @@ func (s *Status) 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"` diff --git a/gkehub/v1alpha2/gkehub-api.json b/gkehub/v1alpha2/gkehub-api.json index f51b2fd1154..bc9ef6817da 100644 --- a/gkehub/v1alpha2/gkehub-api.json +++ b/gkehub/v1alpha2/gkehub-api.json @@ -652,7 +652,7 @@ } } }, - "revision": "20220401", + "revision": "20220408", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AuditConfig": { @@ -738,7 +738,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" }, @@ -1387,7 +1387,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\"`", @@ -1402,7 +1402,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/gkehub/v1alpha2/gkehub-gen.go b/gkehub/v1alpha2/gkehub-gen.go index 2475e606f25..a98efa84ac2 100644 --- a/gkehub/v1alpha2/gkehub-gen.go +++ b/gkehub/v1alpha2/gkehub-gen.go @@ -373,8 +373,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 @@ -1601,7 +1601,7 @@ func (s *ResourceOptions) 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"` @@ -1638,7 +1638,7 @@ func (s *SetIamPolicyRequest) 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"` diff --git a/gkehub/v1beta/gkehub-api.json b/gkehub/v1beta/gkehub-api.json index 98f9f6bdd6c..89b57219f4c 100644 --- a/gkehub/v1beta/gkehub-api.json +++ b/gkehub/v1beta/gkehub-api.json @@ -670,7 +670,7 @@ } } }, - "revision": "20220401", + "revision": "20220408", "rootUrl": "https://gkehub.googleapis.com/", "schemas": { "AnthosObservabilityFeatureSpec": { @@ -777,7 +777,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" }, @@ -1950,6 +1950,10 @@ "$ref": "IdentityServiceMembershipSpec", "description": "Identity Service-specific spec." }, + "mesh": { + "$ref": "ServiceMeshMembershipSpec", + "description": "Anthos Service Mesh-specific spec" + }, "policycontroller": { "$ref": "PolicyControllerMembershipSpec", "description": "Policy Controller spec." @@ -1981,6 +1985,10 @@ "$ref": "PolicyControllerMembershipState", "description": "Policycontroller-specific state." }, + "servicemesh": { + "$ref": "ServiceMeshMembershipState", + "description": "Service Mesh-specific state." + }, "state": { "$ref": "FeatureState", "description": "The high-level state of this Feature for a single membership." @@ -2322,13 +2330,99 @@ }, "type": "object" }, + "ServiceMeshControlPlaneManagement": { + "description": "Status of control plane management.", + "id": "ServiceMeshControlPlaneManagement", + "properties": { + "details": { + "description": "Explanation of state.", + "items": { + "$ref": "ServiceMeshStatusDetails" + }, + "type": "array" + }, + "state": { + "description": "LifecycleState of control plane management.", + "enum": [ + "LIFECYCLE_STATE_UNSPECIFIED", + "DISABLED", + "FAILED_PRECONDITION", + "PROVISIONING", + "ACTIVE", + "STALLED", + "NEEDS_ATTENTION", + "DEGRADED" + ], + "enumDescriptions": [ + "Unspecified", + "DISABLED means that the component is not enabled.", + "FAILED_PRECONDITION means that provisioning cannot proceed because of some characteristic of the member cluster.", + "PROVISIONING means that provisioning is in progress.", + "ACTIVE means that the component is ready for use.", + "STALLED means that provisioning could not be done.", + "NEEDS_ATTENTION means that the component is ready, but some user intervention is required. (For example that the user should migrate workloads to a new control plane revision.)", + "DEGRADED means that the component is ready, but operating in a degraded state." + ], + "type": "string" + } + }, + "type": "object" + }, + "ServiceMeshMembershipSpec": { + "description": "**Service Mesh**: Spec for a single Membership for the servicemesh feature", + "id": "ServiceMeshMembershipSpec", + "properties": { + "controlPlane": { + "description": "Enables automatic control plane management.", + "enum": [ + "CONTROL_PLANE_MANAGEMENT_UNSPECIFIED", + "AUTOMATIC", + "MANUAL" + ], + "enumDescriptions": [ + "Unspecified", + "Google should provision a control plane revision and make it available in the cluster. Google will enroll this revision in a release channel and keep it up to date. The control plane revision may be a managed service, or a managed install.", + "User will manually configure the control plane (e.g. via CLI, or via the ControlPlaneRevision KRM API)" + ], + "type": "string" + } + }, + "type": "object" + }, + "ServiceMeshMembershipState": { + "description": "**Service Mesh**: State for a single Membership, as analyzed by the Service Mesh Hub Controller.", + "id": "ServiceMeshMembershipState", + "properties": { + "controlPlaneManagement": { + "$ref": "ServiceMeshControlPlaneManagement", + "description": "Output only. Status of control plane management", + "readOnly": true + } + }, + "type": "object" + }, + "ServiceMeshStatusDetails": { + "description": "Structured and human-readable details for a status.", + "id": "ServiceMeshStatusDetails", + "properties": { + "code": { + "description": "A machine-readable code that further describes a broad status.", + "type": "string" + }, + "details": { + "description": "Human-readable explanation of code.", + "type": "string" + } + }, + "type": "object" + }, "SetIamPolicyRequest": { "description": "Request message for `SetIamPolicy` method.", "id": "SetIamPolicyRequest", "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\"`", @@ -2370,7 +2464,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/gkehub/v1beta/gkehub-gen.go b/gkehub/v1beta/gkehub-gen.go index e3a4f9c05da..8d410f020a2 100644 --- a/gkehub/v1beta/gkehub-gen.go +++ b/gkehub/v1beta/gkehub-gen.go @@ -410,8 +410,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 @@ -2228,6 +2228,9 @@ type MembershipFeatureSpec struct { // Identityservice: Identity Service-specific spec. Identityservice *IdentityServiceMembershipSpec `json:"identityservice,omitempty"` + // Mesh: Anthos Service Mesh-specific spec + Mesh *ServiceMeshMembershipSpec `json:"mesh,omitempty"` + // Policycontroller: Policy Controller spec. Policycontroller *PolicyControllerMembershipSpec `json:"policycontroller,omitempty"` @@ -2273,6 +2276,9 @@ type MembershipFeatureState struct { // Policycontroller: Policycontroller-specific state. Policycontroller *PolicyControllerMembershipState `json:"policycontroller,omitempty"` + // Servicemesh: Service Mesh-specific state. + Servicemesh *ServiceMeshMembershipState `json:"servicemesh,omitempty"` + // State: The high-level state of this Feature for a single membership. State *FeatureState `json:"state,omitempty"` @@ -2926,11 +2932,160 @@ func (s *PolicyControllerTemplateLibraryConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } +// ServiceMeshControlPlaneManagement: Status of control plane +// management. +type ServiceMeshControlPlaneManagement struct { + // Details: Explanation of state. + Details []*ServiceMeshStatusDetails `json:"details,omitempty"` + + // State: LifecycleState of control plane management. + // + // Possible values: + // "LIFECYCLE_STATE_UNSPECIFIED" - Unspecified + // "DISABLED" - DISABLED means that the component is not enabled. + // "FAILED_PRECONDITION" - FAILED_PRECONDITION means that provisioning + // cannot proceed because of some characteristic of the member cluster. + // "PROVISIONING" - PROVISIONING means that provisioning is in + // progress. + // "ACTIVE" - ACTIVE means that the component is ready for use. + // "STALLED" - STALLED means that provisioning could not be done. + // "NEEDS_ATTENTION" - NEEDS_ATTENTION means that the component is + // ready, but some user intervention is required. (For example that the + // user should migrate workloads to a new control plane revision.) + // "DEGRADED" - DEGRADED means that the component is ready, but + // operating in a degraded state. + State string `json:"state,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Details") to + // unconditionally include in API requests. By default, fields with + // empty or default values are omitted from API requests. 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. "Details") 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 *ServiceMeshControlPlaneManagement) MarshalJSON() ([]byte, error) { + type NoMethod ServiceMeshControlPlaneManagement + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ServiceMeshMembershipSpec: **Service Mesh**: Spec for a single +// Membership for the servicemesh feature +type ServiceMeshMembershipSpec struct { + // ControlPlane: Enables automatic control plane management. + // + // Possible values: + // "CONTROL_PLANE_MANAGEMENT_UNSPECIFIED" - Unspecified + // "AUTOMATIC" - Google should provision a control plane revision and + // make it available in the cluster. Google will enroll this revision in + // a release channel and keep it up to date. The control plane revision + // may be a managed service, or a managed install. + // "MANUAL" - User will manually configure the control plane (e.g. via + // CLI, or via the ControlPlaneRevision KRM API) + ControlPlane string `json:"controlPlane,omitempty"` + + // ForceSendFields is a list of field names (e.g. "ControlPlane") 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. "ControlPlane") 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 *ServiceMeshMembershipSpec) MarshalJSON() ([]byte, error) { + type NoMethod ServiceMeshMembershipSpec + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ServiceMeshMembershipState: **Service Mesh**: State for a single +// Membership, as analyzed by the Service Mesh Hub Controller. +type ServiceMeshMembershipState struct { + // ControlPlaneManagement: Output only. Status of control plane + // management + ControlPlaneManagement *ServiceMeshControlPlaneManagement `json:"controlPlaneManagement,omitempty"` + + // ForceSendFields is a list of field names (e.g. + // "ControlPlaneManagement") 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. "ControlPlaneManagement") + // 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 *ServiceMeshMembershipState) MarshalJSON() ([]byte, error) { + type NoMethod ServiceMeshMembershipState + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ServiceMeshStatusDetails: Structured and human-readable details for a +// status. +type ServiceMeshStatusDetails struct { + // Code: A machine-readable code that further describes a broad status. + Code string `json:"code,omitempty"` + + // Details: Human-readable explanation of code. + Details string `json:"details,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 *ServiceMeshStatusDetails) MarshalJSON() ([]byte, error) { + type NoMethod ServiceMeshStatusDetails + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + // SetIamPolicyRequest: Request message for `SetIamPolicy` method. type SetIamPolicyRequest struct { // Policy: REQUIRED: The complete policy to be applied to the // `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"` @@ -3010,7 +3165,7 @@ func (s *Status) 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"` diff --git a/metastore/v1alpha/metastore-api.json b/metastore/v1alpha/metastore-api.json index ed6c38635f9..c46166b2a76 100644 --- a/metastore/v1alpha/metastore-api.json +++ b/metastore/v1alpha/metastore-api.json @@ -1198,7 +1198,7 @@ } } }, - "revision": "20220331", + "revision": "20220407", "rootUrl": "https://metastore.googleapis.com/", "schemas": { "AuditConfig": { @@ -1342,7 +1342,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" }, @@ -2342,7 +2342,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\"", @@ -2384,7 +2384,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/metastore/v1alpha/metastore-gen.go b/metastore/v1alpha/metastore-gen.go index 9714044bd9b..c1d9c489978 100644 --- a/metastore/v1alpha/metastore-gen.go +++ b/metastore/v1alpha/metastore-gen.go @@ -445,8 +445,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: allUsers: A + // 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 who is authenticated with a Google @@ -2080,7 +2080,7 @@ func (s *Service) 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 (such as + // is a valid policy but certain Google Cloud services (such as // Projects) might reject them. Policy *Policy `json:"policy,omitempty"` @@ -2161,8 +2161,8 @@ func (s *Status) 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 - // allowed. For more information see IAM Overview + // 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"` diff --git a/metastore/v1beta/metastore-api.json b/metastore/v1beta/metastore-api.json index 7fa4963ef6e..b9f9735ca06 100644 --- a/metastore/v1beta/metastore-api.json +++ b/metastore/v1beta/metastore-api.json @@ -1198,7 +1198,7 @@ } } }, - "revision": "20220331", + "revision": "20220407", "rootUrl": "https://metastore.googleapis.com/", "schemas": { "AuditConfig": { @@ -1342,7 +1342,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" }, @@ -2342,7 +2342,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\"", @@ -2384,7 +2384,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/metastore/v1beta/metastore-gen.go b/metastore/v1beta/metastore-gen.go index 65278ef4066..847fe41e58f 100644 --- a/metastore/v1beta/metastore-gen.go +++ b/metastore/v1beta/metastore-gen.go @@ -445,8 +445,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: allUsers: A + // 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 who is authenticated with a Google @@ -2080,7 +2080,7 @@ func (s *Service) 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 (such as + // is a valid policy but certain Google Cloud services (such as // Projects) might reject them. Policy *Policy `json:"policy,omitempty"` @@ -2161,8 +2161,8 @@ func (s *Status) 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 - // allowed. For more information see IAM Overview + // 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"` diff --git a/notebooks/v1/notebooks-api.json b/notebooks/v1/notebooks-api.json index b6bf851bc8c..d8be48b6716 100644 --- a/notebooks/v1/notebooks-api.json +++ b/notebooks/v1/notebooks-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" }, @@ -1781,7 +1781,7 @@ } } }, - "revision": "20220319", + "revision": "20220415", "rootUrl": "https://notebooks.googleapis.com/", "schemas": { "AcceleratorConfig": { @@ -1837,7 +1837,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" }, @@ -2303,13 +2303,15 @@ "DISK_TYPE_UNSPECIFIED", "PD_STANDARD", "PD_SSD", - "PD_BALANCED" + "PD_BALANCED", + "PD_EXTREME" ], "enumDescriptions": [ "Disk type not set.", "Standard persistent disk type.", "SSD persistent disk type.", - "Balanced persistent disk type." + "Balanced persistent disk type.", + "Extreme persistent disk type." ], "type": "string" }, @@ -2347,13 +2349,15 @@ "DISK_TYPE_UNSPECIFIED", "PD_STANDARD", "PD_SSD", - "PD_BALANCED" + "PD_BALANCED", + "PD_EXTREME" ], "enumDescriptions": [ "Disk type not set.", "Standard persistent disk type.", "SSD persistent disk type.", - "Balanced persistent disk type." + "Balanced persistent disk type.", + "Extreme persistent disk type." ], "type": "string" }, @@ -2830,13 +2834,15 @@ "DISK_TYPE_UNSPECIFIED", "PD_STANDARD", "PD_SSD", - "PD_BALANCED" + "PD_BALANCED", + "PD_EXTREME" ], "enumDescriptions": [ "Disk type not set.", "Standard persistent disk type.", "SSD persistent disk type.", - "Balanced persistent disk type." + "Balanced persistent disk type.", + "Extreme persistent disk type." ], "type": "string" }, @@ -3490,7 +3496,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." } }, "type": "object" @@ -3668,7 +3674,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/notebooks/v1/notebooks-gen.go b/notebooks/v1/notebooks-gen.go index b2415b1d854..5077cbd1456 100644 --- a/notebooks/v1/notebooks-gen.go +++ b/notebooks/v1/notebooks-gen.go @@ -293,8 +293,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 @@ -1045,6 +1045,7 @@ type Instance struct { // "PD_STANDARD" - Standard persistent disk type. // "PD_SSD" - SSD persistent disk type. // "PD_BALANCED" - Balanced persistent disk type. + // "PD_EXTREME" - Extreme persistent disk type. BootDiskType string `json:"bootDiskType,omitempty"` // CanIpForward: Optional. Flag to enable ip forwarding or not, default @@ -1081,6 +1082,7 @@ type Instance struct { // "PD_STANDARD" - Standard persistent disk type. // "PD_SSD" - SSD persistent disk type. // "PD_BALANCED" - Balanced persistent disk type. + // "PD_EXTREME" - Extreme persistent disk type. DataDiskType string `json:"dataDiskType,omitempty"` // DiskEncryption: Input only. Disk encryption method used on the boot @@ -1742,6 +1744,7 @@ type LocalDiskInitializeParams struct { // "PD_STANDARD" - Standard persistent disk type. // "PD_SSD" - SSD persistent disk type. // "PD_BALANCED" - Balanced persistent disk type. + // "PD_EXTREME" - Extreme persistent disk type. DiskType string `json:"diskType,omitempty"` // Labels: Optional. Labels to apply to this disk. These can be later @@ -2819,7 +2822,7 @@ func (s *SchedulerAcceleratorConfig) 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"` @@ -3154,7 +3157,7 @@ func (s *SwitchRuntimeRequest) 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"` @@ -3907,8 +3910,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 @@ -4037,7 +4040,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/tpu/v1alpha1/tpu-api.json b/tpu/v1alpha1/tpu-api.json index 3e81252e76f..5d9598451b1 100644 --- a/tpu/v1alpha1/tpu-api.json +++ b/tpu/v1alpha1/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" }, @@ -669,7 +669,7 @@ } } }, - "revision": "20220301", + "revision": "20220412", "rootUrl": "https://tpu.googleapis.com/", "schemas": { "AcceleratorType": { @@ -688,7 +688,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/v1alpha1/tpu-gen.go b/tpu/v1alpha1/tpu-gen.go index 1e0813a6d46..3c8181db5f5 100644 --- a/tpu/v1alpha1/tpu-gen.go +++ b/tpu/v1alpha1/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" // }, diff --git a/tpu/v2alpha1/tpu-api.json b/tpu/v2alpha1/tpu-api.json index 74798920117..3bbcc2993c0 100644 --- a/tpu/v2alpha1/tpu-api.json +++ b/tpu/v2alpha1/tpu-api.json @@ -172,7 +172,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" }, @@ -731,7 +731,7 @@ } } }, - "revision": "20220301", + "revision": "20220412", "rootUrl": "https://tpu.googleapis.com/", "schemas": { "AcceleratorType": { @@ -787,7 +787,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" @@ -1082,7 +1082,7 @@ "id": "Node", "properties": { "acceleratorType": { - "description": "Required. The type of hardware accelerators associated with this node.", + "description": "The type of hardware accelerators associated with this node.", "type": "string" }, "apiVersion": { diff --git a/tpu/v2alpha1/tpu-gen.go b/tpu/v2alpha1/tpu-gen.go index e209409ccf4..b40f3a06528 100644 --- a/tpu/v2alpha1/tpu-gen.go +++ b/tpu/v2alpha1/tpu-gen.go @@ -315,8 +315,7 @@ func (s *AttachedDisk) 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. @@ -841,8 +840,8 @@ func (s *NetworkEndpoint) MarshalJSON() ([]byte, error) { // Node: A TPU instance. type Node struct { - // AcceleratorType: Required. The type of hardware accelerators - // associated with this node. + // AcceleratorType: The type of hardware accelerators associated with + // this node. AcceleratorType string `json:"acceleratorType,omitempty"` // ApiVersion: Output only. The API version that created this Node. @@ -1633,8 +1632,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 @@ -1763,7 +1762,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/workflows/v1/workflows-api.json b/workflows/v1/workflows-api.json index c6ae34a3ed9..c676bcb4252 100644 --- a/workflows/v1/workflows-api.json +++ b/workflows/v1/workflows-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" }, @@ -444,7 +444,7 @@ } } }, - "revision": "20220323", + "revision": "20220406", "rootUrl": "https://workflows.googleapis.com/", "schemas": { "Empty": { diff --git a/workflows/v1/workflows-gen.go b/workflows/v1/workflows-gen.go index 60a20d30b80..d19d6f8a7ce 100644 --- a/workflows/v1/workflows-gen.go +++ b/workflows/v1/workflows-gen.go @@ -761,8 +761,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 @@ -891,7 +891,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" // }, From c75dc07eff1e5057d94a02da6b887b990fe8ad80 Mon Sep 17 00:00:00 2001 From: WhiteSource Renovate Date: Mon, 18 Apr 2022 16:56:51 +0200 Subject: [PATCH 14/17] chore(all): update all (#1515) --- go.mod | 14 +++++++------- go.sum | 29 +++++++++++++++++++---------- internal/kokoro/discogen/go.mod | 2 +- internal/kokoro/discogen/go.sum | 4 ++-- 4 files changed, 29 insertions(+), 20 deletions(-) diff --git a/go.mod b/go.mod index 276f23d8cf9..006261b06bd 100644 --- a/go.mod +++ b/go.mod @@ -3,16 +3,16 @@ module google.golang.org/api go 1.15 require ( - cloud.google.com/go/compute v1.5.0 + cloud.google.com/go/compute v1.6.0 github.com/google/go-cmp v0.5.7 - github.com/googleapis/gax-go/v2 v2.2.0 + github.com/googleapis/gax-go/v2 v2.3.0 go.opencensus.io v0.23.0 - golang.org/x/net v0.0.0-20220407224826-aac1ed45d8e3 - golang.org/x/oauth2 v0.0.0-20220309155454-6242fa91716a + golang.org/x/net v0.0.0-20220412020605-290c469a71a5 + golang.org/x/oauth2 v0.0.0-20220411215720-9780585627b5 golang.org/x/sync v0.0.0-20210220032951-036812b2e83c - golang.org/x/sys v0.0.0-20220408201424-a24fb2fb8a0f - golang.org/x/xerrors v0.0.0-20220411182839-cd4e9df8ec86 + golang.org/x/sys v0.0.0-20220412211240-33da011f77ad + golang.org/x/xerrors v0.0.0-20220411194840-2f41105eb62f google.golang.org/appengine v1.6.7 - google.golang.org/genproto v0.0.0-20220407144326-9054f6ed7bac + google.golang.org/genproto v0.0.0-20220414192740-2d67ff6cf2b4 google.golang.org/grpc v1.45.0 ) diff --git a/go.sum b/go.sum index 87431941aad..ddaa2fab06b 100644 --- a/go.sum +++ b/go.sum @@ -36,8 +36,9 @@ cloud.google.com/go/bigquery v1.7.0/go.mod h1://okPTzCYNXSlb24MZs83e2Do+h+VXtc4g cloud.google.com/go/bigquery v1.8.0/go.mod h1:J5hqkt3O0uAFnINi6JXValWIb1v0goeZM77hZzJN/fQ= cloud.google.com/go/compute v0.1.0/go.mod h1:GAesmwr110a34z04OlxYkATPBEfVhkymfTBXtfbBFow= cloud.google.com/go/compute v1.3.0/go.mod h1:cCZiE1NHEtai4wiufUhW8I8S1JKkAnhnQJWM7YD99wM= -cloud.google.com/go/compute v1.5.0 h1:b1zWmYuuHz7gO9kDcM/EpHGr06UgsYNRpNJzI2kFiLM= cloud.google.com/go/compute v1.5.0/go.mod h1:9SMHyhJlzhlkJqrPAc839t2BZFTSk6Jdj6mkzQJeu0M= +cloud.google.com/go/compute v1.6.0 h1:XdQIN5mdPTSBVwSIVDuY5e8ZzVAccsHvD3qTEz4zIps= +cloud.google.com/go/compute v1.6.0/go.mod h1:T29tfhtVbq1wvAPo0E3+7vhgmkOYeXjhFvz/FMzPu0s= cloud.google.com/go/datastore v1.0.0/go.mod h1:LXYbyblFSglQ5pkeyhO+Qmw7ukd3C+pD7TKLgZqpHYE= cloud.google.com/go/datastore v1.1.0/go.mod h1:umbIZjpQpHh4hmRpGhH4tLFup+FVzqBi1b3c64qFpCk= cloud.google.com/go/pubsub v1.0.1/go.mod h1:R0Gpsv3s54REJCy4fxDixWD93lHJMoZTyQ2kNxGRt3I= @@ -156,8 +157,9 @@ github.com/googleapis/gax-go/v2 v2.0.4/go.mod h1:0Wqv26UfaUD9n4G6kQubkQ+KchISgw+ github.com/googleapis/gax-go/v2 v2.0.5/go.mod h1:DWXyrwAJ9X0FpwwEdw+IPEYBICEFu5mhpdKc/us6bOk= github.com/googleapis/gax-go/v2 v2.1.0/go.mod h1:Q3nei7sK6ybPYH7twZdmQpAd1MKb7pfu6SK+H1/DsU0= github.com/googleapis/gax-go/v2 v2.1.1/go.mod h1:hddJymUZASv3XPyGkUpKj8pPO47Rmb0eJc8R6ouapiM= -github.com/googleapis/gax-go/v2 v2.2.0 h1:s7jOdKSaksJVOxE0Y/S32otcfiP+UQ0cL8/GTKaONwE= github.com/googleapis/gax-go/v2 v2.2.0/go.mod h1:as02EH8zWkzwUoLbBaFeQ+arQaj/OthfcblKl4IGNaM= +github.com/googleapis/gax-go/v2 v2.3.0 h1:nRJtk3y8Fm770D42QV6T90ZnvFZyk7agSo3Q+Z9p3WI= +github.com/googleapis/gax-go/v2 v2.3.0/go.mod h1:b8LNqSzNabLiUpXKkY7HAR5jr6bIT99EXz9pXxye9YM= github.com/grpc-ecosystem/grpc-gateway v1.16.0/go.mod h1:BDjrQk3hbvj6Nolgz8mAMFbcEtjT1g+wF4CSlocrBnw= github.com/hashicorp/golang-lru v0.5.0/go.mod h1:/m3WP610KZHVQ1SGc6re/UDhFvYD7pJ4Ao+sR/qLZy8= github.com/hashicorp/golang-lru v0.5.1/go.mod h1:/m3WP610KZHVQ1SGc6re/UDhFvYD7pJ4Ao+sR/qLZy8= @@ -270,8 +272,9 @@ golang.org/x/net v0.0.0-20210405180319-a5a99cb37ef4/go.mod h1:p54w0d4576C0XHj96b golang.org/x/net v0.0.0-20210503060351-7fd8e65b6420/go.mod h1:9nx3DQGgdP8bBQD5qxJ1jj9UTztislL4KSBs9R2vV5Y= golang.org/x/net v0.0.0-20220127200216-cd36cc0744dd/go.mod h1:CfG3xpIq0wQ8r1q4Su4UZFWDARRcnwPjda9FqA0JpMk= golang.org/x/net v0.0.0-20220225172249-27dd8689420f/go.mod h1:CfG3xpIq0wQ8r1q4Su4UZFWDARRcnwPjda9FqA0JpMk= -golang.org/x/net v0.0.0-20220407224826-aac1ed45d8e3 h1:EN5+DfgmRMvRUrMGERW2gQl3Vc+Z7ZMnI/xdEpPSf0c= -golang.org/x/net v0.0.0-20220407224826-aac1ed45d8e3/go.mod h1:CfG3xpIq0wQ8r1q4Su4UZFWDARRcnwPjda9FqA0JpMk= +golang.org/x/net v0.0.0-20220325170049-de3da57026de/go.mod h1:CfG3xpIq0wQ8r1q4Su4UZFWDARRcnwPjda9FqA0JpMk= +golang.org/x/net v0.0.0-20220412020605-290c469a71a5 h1:bRb386wvrE+oBNdF1d/Xh9mQrfQ4ecYhW5qJ5GvTGT4= +golang.org/x/net v0.0.0-20220412020605-290c469a71a5/go.mod h1:CfG3xpIq0wQ8r1q4Su4UZFWDARRcnwPjda9FqA0JpMk= golang.org/x/oauth2 v0.0.0-20180821212333-d2e6202438be/go.mod h1:N/0e6XlmueqKjAGxoOufVs8QHGRruUQn6yWY3a++T0U= golang.org/x/oauth2 v0.0.0-20190226205417-e64efc72b421/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= golang.org/x/oauth2 v0.0.0-20190604053449-0f29369cfe45/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= @@ -289,8 +292,9 @@ golang.org/x/oauth2 v0.0.0-20210805134026-6f1e6394065a/go.mod h1:KelEdhl1UZF7XfJ golang.org/x/oauth2 v0.0.0-20210819190943-2bc19b11175f/go.mod h1:KelEdhl1UZF7XfJ4dDtk6s++YSgaE7mD/BuKKDLBl4A= golang.org/x/oauth2 v0.0.0-20211104180415-d3ed0bb246c8/go.mod h1:KelEdhl1UZF7XfJ4dDtk6s++YSgaE7mD/BuKKDLBl4A= golang.org/x/oauth2 v0.0.0-20220223155221-ee480838109b/go.mod h1:DAh4E804XQdzx2j+YRIaUnCqCV2RuMz24cGBJ5QYIrc= -golang.org/x/oauth2 v0.0.0-20220309155454-6242fa91716a h1:qfl7ob3DIEs3Ml9oLuPwY2N04gymzAW04WsUQHIClgM= golang.org/x/oauth2 v0.0.0-20220309155454-6242fa91716a/go.mod h1:DAh4E804XQdzx2j+YRIaUnCqCV2RuMz24cGBJ5QYIrc= +golang.org/x/oauth2 v0.0.0-20220411215720-9780585627b5 h1:OSnWWcOd/CtWQC2cYSBgbTSJv3ciqd8r54ySIW2y3RE= +golang.org/x/oauth2 v0.0.0-20220411215720-9780585627b5/go.mod h1:DAh4E804XQdzx2j+YRIaUnCqCV2RuMz24cGBJ5QYIrc= golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20181108010431-42b317875d0f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20181221193216-37e7f081c4d4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= @@ -355,8 +359,9 @@ golang.org/x/sys v0.0.0-20211216021012-1d35b9e2eb4e/go.mod h1:oPkhp1MJrh7nUepCBc golang.org/x/sys v0.0.0-20220128215802-99c3d69c2c27/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.0.0-20220209214540-3681064d5158/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.0.0-20220227234510-4e6760a101f9/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.0.0-20220408201424-a24fb2fb8a0f h1:8w7RhxzTVgUzw/AH/9mUV5q0vMgy40SQRursCcfmkCw= -golang.org/x/sys v0.0.0-20220408201424-a24fb2fb8a0f/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.0.0-20220328115105-d36c6a25d886/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.0.0-20220412211240-33da011f77ad h1:ntjMns5wyP/fN65tdBD4g8J5w8n015+iIIs9rtjXkY0= +golang.org/x/sys v0.0.0-20220412211240-33da011f77ad/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo= golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= golang.org/x/text v0.0.0-20170915032832-14c0d48ead0c/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= @@ -427,8 +432,8 @@ golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8T golang.org/x/xerrors v0.0.0-20191011141410-1b5146add898/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= -golang.org/x/xerrors v0.0.0-20220411182839-cd4e9df8ec86 h1:lX9l83i65uxQFfIS7nmg8tFhgtTdFVSTBmLv01vnMZY= -golang.org/x/xerrors v0.0.0-20220411182839-cd4e9df8ec86/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= +golang.org/x/xerrors v0.0.0-20220411194840-2f41105eb62f h1:GGU+dLjvlC3qDwqYgL6UgRmHXhOOgns0bZu2Ty5mm6U= +golang.org/x/xerrors v0.0.0-20220411194840-2f41105eb62f/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= google.golang.org/api v0.4.0/go.mod h1:8k5glujaEP+g9n7WNsDg8QP6cUVNI86fCNMcbazEtwE= google.golang.org/api v0.7.0/go.mod h1:WtwebWUNSVBH/HAw79HIFXZNqEvBhG+Ra+ax0hx3E3M= google.golang.org/api v0.8.0/go.mod h1:o4eAsZoiT+ibD93RtjEohWalFOjRDx6CVaqeizhEnKg= @@ -463,6 +468,7 @@ google.golang.org/api v0.63.0/go.mod h1:gs4ij2ffTRXwuzzgJl/56BdwJaA194ijkfn++9tD google.golang.org/api v0.67.0/go.mod h1:ShHKP8E60yPsKNw/w8w+VYaj9H6buA5UqDp8dhbQZ6g= google.golang.org/api v0.70.0/go.mod h1:Bs4ZM2HGifEvXwd50TtW70ovgJffJYw2oRCOFU/SkfA= google.golang.org/api v0.71.0/go.mod h1:4PyU6e6JogV1f9eA4voyrTY2batOLdgZ5qZ5HOCc4j8= +google.golang.org/api v0.74.0/go.mod h1:ZpfMZOVRMywNyvJFeqL9HRWBgAuRfSjJFpe9QtRRyDs= google.golang.org/appengine v1.1.0/go.mod h1:EbEs0AVv82hx2wNQdGPgUI5lhzA/G0D9YwlJXL52JkM= google.golang.org/appengine v1.4.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4= google.golang.org/appengine v1.5.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4= @@ -537,8 +543,11 @@ google.golang.org/genproto v0.0.0-20220218161850-94dd64e39d7c/go.mod h1:kGP+zUP2 google.golang.org/genproto v0.0.0-20220222213610-43724f9ea8cf/go.mod h1:kGP+zUP2Ddo0ayMi4YuN7C3WZyJvGLZRh8Z5wnAqvEI= google.golang.org/genproto v0.0.0-20220304144024-325a89244dc8/go.mod h1:kGP+zUP2Ddo0ayMi4YuN7C3WZyJvGLZRh8Z5wnAqvEI= google.golang.org/genproto v0.0.0-20220310185008-1973136f34c6/go.mod h1:kGP+zUP2Ddo0ayMi4YuN7C3WZyJvGLZRh8Z5wnAqvEI= -google.golang.org/genproto v0.0.0-20220407144326-9054f6ed7bac h1:qSNTkEN+L2mvWcLgJOR+8bdHX9rN/IdU3A1Ghpfb1Rg= +google.golang.org/genproto v0.0.0-20220324131243-acbaeb5b85eb/go.mod h1:hAL49I2IFola2sVEjAn7MEwsja0xp51I0tlGAf9hz4E= google.golang.org/genproto v0.0.0-20220407144326-9054f6ed7bac/go.mod h1:8w6bsBMX6yCPbAVTeqQHvzxW0EIFigd5lZyahWgyfDo= +google.golang.org/genproto v0.0.0-20220413183235-5e96e2839df9/go.mod h1:8w6bsBMX6yCPbAVTeqQHvzxW0EIFigd5lZyahWgyfDo= +google.golang.org/genproto v0.0.0-20220414192740-2d67ff6cf2b4 h1:myaecH64R0bIEDjNORIel4iXubqzaHU1K2z8ajBwWcM= +google.golang.org/genproto v0.0.0-20220414192740-2d67ff6cf2b4/go.mod h1:8w6bsBMX6yCPbAVTeqQHvzxW0EIFigd5lZyahWgyfDo= google.golang.org/grpc v1.19.0/go.mod h1:mqu4LbDTu4XGKhr4mRzUsmM4RtVoemTSY81AxZiDr8c= google.golang.org/grpc v1.20.1/go.mod h1:10oTOabMzJvdu6/UiuZezV6QK5dSlG84ov/aaiqXj38= google.golang.org/grpc v1.21.1/go.mod h1:oYelfM1adQP15Ek0mdvEgi9Df8B9CZIaU1084ijfRaM= diff --git a/internal/kokoro/discogen/go.mod b/internal/kokoro/discogen/go.mod index e2e4c7be8b1..8f8979c9733 100644 --- a/internal/kokoro/discogen/go.mod +++ b/internal/kokoro/discogen/go.mod @@ -4,7 +4,7 @@ go 1.17 require ( github.com/google/go-github/v42 v42.0.0 - golang.org/x/oauth2 v0.0.0-20220309155454-6242fa91716a + golang.org/x/oauth2 v0.0.0-20220411215720-9780585627b5 ) require ( diff --git a/internal/kokoro/discogen/go.sum b/internal/kokoro/discogen/go.sum index 3ed2bcba6ee..b0e0a8ec0b7 100644 --- a/internal/kokoro/discogen/go.sum +++ b/internal/kokoro/discogen/go.sum @@ -196,8 +196,8 @@ golang.org/x/oauth2 v0.0.0-20190226205417-e64efc72b421/go.mod h1:gOpvHmFTYa4Iltr golang.org/x/oauth2 v0.0.0-20190604053449-0f29369cfe45/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= golang.org/x/oauth2 v0.0.0-20191202225959-858c2ad4c8b6/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= golang.org/x/oauth2 v0.0.0-20200107190931-bf48bf16ab8d/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= -golang.org/x/oauth2 v0.0.0-20220309155454-6242fa91716a h1:qfl7ob3DIEs3Ml9oLuPwY2N04gymzAW04WsUQHIClgM= -golang.org/x/oauth2 v0.0.0-20220309155454-6242fa91716a/go.mod h1:DAh4E804XQdzx2j+YRIaUnCqCV2RuMz24cGBJ5QYIrc= +golang.org/x/oauth2 v0.0.0-20220411215720-9780585627b5 h1:OSnWWcOd/CtWQC2cYSBgbTSJv3ciqd8r54ySIW2y3RE= +golang.org/x/oauth2 v0.0.0-20220411215720-9780585627b5/go.mod h1:DAh4E804XQdzx2j+YRIaUnCqCV2RuMz24cGBJ5QYIrc= golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20181108010431-42b317875d0f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20181221193216-37e7f081c4d4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= From 4145f3dc4376236f13e9e8b33ce4c0a92e6fcebd Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Wed, 20 Apr 2022 08:06:27 -0700 Subject: [PATCH 15/17] feat(all): auto-regenerate discovery clients (#1516) --- 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" // }, From 12c0cb2af5ab60c1f8343cb43fd55059ce6d9f0d Mon Sep 17 00:00:00 2001 From: Cody Oss <6331106+codyoss@users.noreply.github.com> Date: Wed, 20 Apr 2022 14:17:47 -0600 Subject: [PATCH 16/17] chore: update CI script to run on 1.18 (#1508) --- internal/kokoro/vet.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/internal/kokoro/vet.sh b/internal/kokoro/vet.sh index acf13e187d3..5dd77c6b9aa 100755 --- a/internal/kokoro/vet.sh +++ b/internal/kokoro/vet.sh @@ -7,7 +7,7 @@ # Fail on error, and display commands being run. set -ex -if [[ $(go version) != *"go1.17"* ]]; then +if [[ $(go version) != *"go1.18"* ]]; then exit 0 fi From 702783924de298b278434494e613adb302b45fe1 Mon Sep 17 00:00:00 2001 From: "release-please[bot]" <55107282+release-please[bot]@users.noreply.github.com> Date: Wed, 20 Apr 2022 15:32:21 -0600 Subject: [PATCH 17/17] chore(main): release 0.75.0 (#1497) Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com> Co-authored-by: Chris Smith --- CHANGES.md | 8 ++++++++ internal/version.go | 2 +- 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/CHANGES.md b/CHANGES.md index 222aee2133f..f33ebe77666 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -1,5 +1,13 @@ # Changes +## [0.75.0](https://github.com/googleapis/google-api-go-client/compare/v0.74.0...v0.75.0) (2022-04-20) + + +### Features + +* **all:** auto-regenerate discovery clients, refs [#1516](https://github.com/googleapis/google-api-go-client/issues/1516) [#1514](https://github.com/googleapis/google-api-go-client/issues/1514) [#1513](https://github.com/googleapis/google-api-go-client/issues/1513) [#1511](https://github.com/googleapis/google-api-go-client/issues/1511) [#1510](https://github.com/googleapis/google-api-go-client/issues/1510) [#1509](https://github.com/googleapis/google-api-go-client/issues/1509) [#1504](https://github.com/googleapis/google-api-go-client/issues/1504) [#1503](https://github.com/googleapis/google-api-go-client/issues/1503) [#1500](https://github.com/googleapis/google-api-go-client/issues/1500) [#1498](https://github.com/googleapis/google-api-go-client/issues/1498) [#1496](https://github.com/googleapis/google-api-go-client/issues/1496) +* **transport:** remove grpc version guard ([#1506](https://github.com/googleapis/google-api-go-client/issues/1506)) ([d349e85](https://github.com/googleapis/google-api-go-client/commit/d349e8569473af826a87ebbeff59c90455f8490f)) + ## [0.74.0](https://github.com/googleapis/google-api-go-client/compare/v0.73.0...v0.74.0) (2022-03-30) diff --git a/internal/version.go b/internal/version.go index 66b62400adf..3599baa0feb 100644 --- a/internal/version.go +++ b/internal/version.go @@ -5,4 +5,4 @@ package internal // Version is the current tagged release of the library. -const Version = "0.74.0" +const Version = "0.75.0"