all: autogenerated update (2019-06-16)
Update:
- bigtableadmin/v1
- bigtableadmin/v2
- cloudfunctions/v1
- cloudshell/v1
- cloudshell/v1alpha1
- dataproc/v1
- dataproc/v1beta2
- dialogflow/v2
- dialogflow/v2beta1
- dns/v1beta2
- iam/v1
- logging/v2
- monitoring/v3
- pubsub/v1
- remotebuildexecution/v1
- remotebuildexecution/v1alpha
- remotebuildexecution/v2
- servicecontrol/v1
- servicemanagement/v1
- toolresults/v1beta3
diff --git a/bigtableadmin/v1/bigtableadmin-api.json b/bigtableadmin/v1/bigtableadmin-api.json
index e5eb062..e9e1f9a 100644
--- a/bigtableadmin/v1/bigtableadmin-api.json
+++ b/bigtableadmin/v1/bigtableadmin-api.json
@@ -94,77 +94,8 @@
}
},
"protocol": "rest",
- "resources": {
- "projects": {
- "resources": {
- "locations": {
- "methods": {
- "get": {
- "description": "Gets information about a location.",
- "flatPath": "v1/projects/{projectsId}/locations/{locationsId}",
- "httpMethod": "GET",
- "id": "bigtableadmin.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"
- }
- },
- "list": {
- "description": "Lists information about the supported locations for this service.",
- "flatPath": "v1/projects/{projectsId}/locations",
- "httpMethod": "GET",
- "id": "bigtableadmin.projects.locations.list",
- "parameterOrder": [
- "name"
- ],
- "parameters": {
- "filter": {
- "description": "The standard list filter.",
- "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 standard list page size.",
- "format": "int32",
- "location": "query",
- "type": "integer"
- },
- "pageToken": {
- "description": "The standard list page token.",
- "location": "query",
- "type": "string"
- }
- },
- "path": "v1/{+name}/locations",
- "response": {
- "$ref": "ListLocationsResponse"
- }
- }
- }
- }
- }
- }
- },
- "revision": "20190328",
+ "resources": {},
+ "revision": "20190506",
"rootUrl": "https://bigtableadmin.googleapis.com/",
"schemas": {
"Cluster": {
@@ -363,58 +294,6 @@
},
"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"
- },
- "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.\nFor example, \"Tokyo\".",
- "type": "string"
- },
- "labels": {
- "additionalProperties": {
- "type": "string"
- },
- "description": "Cross-service attributes for the location. For example\n\n {\"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\nlocation.",
- "type": "object"
- },
- "name": {
- "description": "Resource name for the location, which may vary between implementations.\nFor example: `\"projects/example-project/locations/us-east1\"`",
- "type": "string"
- }
- },
- "type": "object"
- },
"PartialUpdateInstanceRequest": {
"description": "Request message for BigtableInstanceAdmin.PartialUpdateInstance.",
"id": "PartialUpdateInstanceRequest",
diff --git a/bigtableadmin/v1/bigtableadmin-gen.go b/bigtableadmin/v1/bigtableadmin-gen.go
index 423468d..4648842 100644
--- a/bigtableadmin/v1/bigtableadmin-gen.go
+++ b/bigtableadmin/v1/bigtableadmin-gen.go
@@ -100,7 +100,6 @@
return nil, errors.New("client is nil")
}
s := &Service{client: client, BasePath: basePath}
- s.Projects = NewProjectsService(s)
return s, nil
}
@@ -108,8 +107,6 @@
client *http.Client
BasePath string // API endpoint base URL
UserAgent string // optional additional User-Agent fragment
-
- Projects *ProjectsService
}
func (s *Service) userAgent() string {
@@ -119,27 +116,6 @@
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}
- return rs
-}
-
-type ProjectsLocationsService struct {
- s *Service
-}
-
// Cluster: A resizable group of nodes in a particular cloud location,
// capable
// of serving all Tables in the parent
@@ -506,96 +482,6 @@
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 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)
-}
-
-// 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 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)
-}
-
// PartialUpdateInstanceRequest: Request message for
// BigtableInstanceAdmin.PartialUpdateInstance.
type PartialUpdateInstanceRequest struct {
@@ -759,342 +645,3 @@
raw := NoMethod(*s)
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
-
-// method id "bigtableadmin.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.
-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)
- 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 "bigtableadmin.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": "bigtableadmin.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"
- // }
- // }
-
-}
-
-// method id "bigtableadmin.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.
-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": The standard list
-// filter.
-func (c *ProjectsLocationsListCall) Filter(filter string) *ProjectsLocationsListCall {
- c.urlParams_.Set("filter", filter)
- return c
-}
-
-// PageSize sets the optional parameter "pageSize": The standard list
-// page size.
-func (c *ProjectsLocationsListCall) PageSize(pageSize int64) *ProjectsLocationsListCall {
- c.urlParams_.Set("pageSize", fmt.Sprint(pageSize))
- return c
-}
-
-// PageToken sets the optional parameter "pageToken": The standard list
-// page token.
-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)
- 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 "bigtableadmin.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": "bigtableadmin.projects.locations.list",
- // "parameterOrder": [
- // "name"
- // ],
- // "parameters": {
- // "filter": {
- // "description": "The standard list filter.",
- // "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 standard list page size.",
- // "format": "int32",
- // "location": "query",
- // "type": "integer"
- // },
- // "pageToken": {
- // "description": "The standard list page token.",
- // "location": "query",
- // "type": "string"
- // }
- // },
- // "path": "v1/{+name}/locations",
- // "response": {
- // "$ref": "ListLocationsResponse"
- // }
- // }
-
-}
-
-// 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)
- }
-}
diff --git a/bigtableadmin/v2/bigtableadmin-api.json b/bigtableadmin/v2/bigtableadmin-api.json
index f870fe2..ffbe6a0 100644
--- a/bigtableadmin/v2/bigtableadmin-api.json
+++ b/bigtableadmin/v2/bigtableadmin-api.json
@@ -694,7 +694,8 @@
"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"
+ "https://www.googleapis.com/auth/cloud-platform",
+ "https://www.googleapis.com/auth/cloud-platform.read-only"
]
},
"list": {
@@ -1341,11 +1342,93 @@
}
}
}
+ },
+ "locations": {
+ "methods": {
+ "get": {
+ "description": "Gets information about a location.",
+ "flatPath": "v2/projects/{projectsId}/locations/{locationsId}",
+ "httpMethod": "GET",
+ "id": "bigtableadmin.projects.locations.get",
+ "parameterOrder": [
+ "name"
+ ],
+ "parameters": {
+ "name": {
+ "description": "Resource name for the location.",
+ "location": "path",
+ "pattern": "^projects/[^/]+/locations/[^/]+$",
+ "required": true,
+ "type": "string"
+ }
+ },
+ "path": "v2/{+name}",
+ "response": {
+ "$ref": "Location"
+ },
+ "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",
+ "https://www.googleapis.com/auth/cloud-platform.read-only"
+ ]
+ },
+ "list": {
+ "description": "Lists information about the supported locations for this service.",
+ "flatPath": "v2/projects/{projectsId}/locations",
+ "httpMethod": "GET",
+ "id": "bigtableadmin.projects.locations.list",
+ "parameterOrder": [
+ "name"
+ ],
+ "parameters": {
+ "filter": {
+ "description": "The standard list filter.",
+ "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 standard list page size.",
+ "format": "int32",
+ "location": "query",
+ "type": "integer"
+ },
+ "pageToken": {
+ "description": "The standard list page token.",
+ "location": "query",
+ "type": "string"
+ }
+ },
+ "path": "v2/{+name}/locations",
+ "response": {
+ "$ref": "ListLocationsResponse"
+ },
+ "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",
+ "https://www.googleapis.com/auth/cloud-platform.read-only"
+ ]
+ }
+ }
}
}
}
},
- "revision": "20190406",
+ "revision": "20190506",
"rootUrl": "https://bigtableadmin.googleapis.com/",
"schemas": {
"AppProfile": {
@@ -1903,6 +1986,24 @@
},
"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"
+ },
"ListOperationsResponse": {
"description": "The response message for Operations.ListOperations.",
"id": "ListOperationsResponse",
@@ -1939,6 +2040,40 @@
},
"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.\nFor example, \"Tokyo\".",
+ "type": "string"
+ },
+ "labels": {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "description": "Cross-service attributes for the location. For example\n\n {\"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\nlocation.",
+ "type": "object"
+ },
+ "name": {
+ "description": "Resource name for the location, which may vary between implementations.\nFor example: `\"projects/example-project/locations/us-east1\"`",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
"Modification": {
"description": "A create, update, or delete of a particular column family.",
"id": "Modification",
diff --git a/bigtableadmin/v2/bigtableadmin-gen.go b/bigtableadmin/v2/bigtableadmin-gen.go
index ef8230a..d5a9206 100644
--- a/bigtableadmin/v2/bigtableadmin-gen.go
+++ b/bigtableadmin/v2/bigtableadmin-gen.go
@@ -205,6 +205,7 @@
func NewProjectsService(s *Service) *ProjectsService {
rs := &ProjectsService{s: s}
rs.Instances = NewProjectsInstancesService(s)
+ rs.Locations = NewProjectsLocationsService(s)
return rs
}
@@ -212,6 +213,8 @@
s *Service
Instances *ProjectsInstancesService
+
+ Locations *ProjectsLocationsService
}
func NewProjectsInstancesService(s *Service) *ProjectsInstancesService {
@@ -259,6 +262,15 @@
s *Service
}
+func NewProjectsLocationsService(s *Service) *ProjectsLocationsService {
+ rs := &ProjectsLocationsService{s: s}
+ return rs
+}
+
+type ProjectsLocationsService struct {
+ s *Service
+}
+
// AppProfile: A configuration object describing how Cloud Bigtable
// should treat traffic
// from a particular end user application.
@@ -1504,6 +1516,43 @@
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 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)
+}
+
// ListOperationsResponse: The response message for
// Operations.ListOperations.
type ListOperationsResponse struct {
@@ -1582,6 +1631,59 @@
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 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)
+}
+
// Modification: A create, update, or delete of a particular column
// family.
type Modification struct {
@@ -4900,7 +5002,8 @@
// "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"
+ // "https://www.googleapis.com/auth/cloud-platform",
+ // "https://www.googleapis.com/auth/cloud-platform.read-only"
// ]
// }
@@ -7752,3 +7855,360 @@
// }
}
+
+// method id "bigtableadmin.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.
+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)
+ 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/{+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 "bigtableadmin.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": "v2/projects/{projectsId}/locations/{locationsId}",
+ // "httpMethod": "GET",
+ // "id": "bigtableadmin.projects.locations.get",
+ // "parameterOrder": [
+ // "name"
+ // ],
+ // "parameters": {
+ // "name": {
+ // "description": "Resource name for the location.",
+ // "location": "path",
+ // "pattern": "^projects/[^/]+/locations/[^/]+$",
+ // "required": true,
+ // "type": "string"
+ // }
+ // },
+ // "path": "v2/{+name}",
+ // "response": {
+ // "$ref": "Location"
+ // },
+ // "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",
+ // "https://www.googleapis.com/auth/cloud-platform.read-only"
+ // ]
+ // }
+
+}
+
+// method id "bigtableadmin.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.
+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": The standard list
+// filter.
+func (c *ProjectsLocationsListCall) Filter(filter string) *ProjectsLocationsListCall {
+ c.urlParams_.Set("filter", filter)
+ return c
+}
+
+// PageSize sets the optional parameter "pageSize": The standard list
+// page size.
+func (c *ProjectsLocationsListCall) PageSize(pageSize int64) *ProjectsLocationsListCall {
+ c.urlParams_.Set("pageSize", fmt.Sprint(pageSize))
+ return c
+}
+
+// PageToken sets the optional parameter "pageToken": The standard list
+// page token.
+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)
+ 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/{+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 "bigtableadmin.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": "v2/projects/{projectsId}/locations",
+ // "httpMethod": "GET",
+ // "id": "bigtableadmin.projects.locations.list",
+ // "parameterOrder": [
+ // "name"
+ // ],
+ // "parameters": {
+ // "filter": {
+ // "description": "The standard list filter.",
+ // "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 standard list page size.",
+ // "format": "int32",
+ // "location": "query",
+ // "type": "integer"
+ // },
+ // "pageToken": {
+ // "description": "The standard list page token.",
+ // "location": "query",
+ // "type": "string"
+ // }
+ // },
+ // "path": "v2/{+name}/locations",
+ // "response": {
+ // "$ref": "ListLocationsResponse"
+ // },
+ // "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",
+ // "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 *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)
+ }
+}
diff --git a/cloudfunctions/v1/cloudfunctions-api.json b/cloudfunctions/v1/cloudfunctions-api.json
index f1f4c51..7824838 100644
--- a/cloudfunctions/v1/cloudfunctions-api.json
+++ b/cloudfunctions/v1/cloudfunctions-api.json
@@ -539,7 +539,7 @@
}
}
},
- "revision": "20190521",
+ "revision": "20190529",
"rootUrl": "https://cloudfunctions.googleapis.com/",
"schemas": {
"AuditConfig": {
@@ -726,7 +726,7 @@
],
"enumDescriptions": [
"Not specified. Invalid state.",
- "Function has been succesfully deployed and is serving.",
+ "Function has been successfully deployed and is serving.",
"Function deployment failed and the function isn’t serving.",
"Function is being created or updated.",
"Function is being deleted.",
diff --git a/cloudfunctions/v1/cloudfunctions-gen.go b/cloudfunctions/v1/cloudfunctions-gen.go
index e602461..35d608f 100644
--- a/cloudfunctions/v1/cloudfunctions-gen.go
+++ b/cloudfunctions/v1/cloudfunctions-gen.go
@@ -585,7 +585,7 @@
//
// Possible values:
// "CLOUD_FUNCTION_STATUS_UNSPECIFIED" - Not specified. Invalid state.
- // "ACTIVE" - Function has been succesfully deployed and is serving.
+ // "ACTIVE" - Function has been successfully deployed and is serving.
// "OFFLINE" - Function deployment failed and the function isn’t
// serving.
// "DEPLOY_IN_PROGRESS" - Function is being created or updated.
diff --git a/cloudshell/v1/cloudshell-api.json b/cloudshell/v1/cloudshell-api.json
index e0e9050..f987c3c 100644
--- a/cloudshell/v1/cloudshell-api.json
+++ b/cloudshell/v1/cloudshell-api.json
@@ -228,7 +228,7 @@
}
}
},
- "revision": "20190514",
+ "revision": "20190610",
"rootUrl": "https://cloudshell.googleapis.com/",
"schemas": {
"CancelOperationRequest": {
@@ -422,7 +422,7 @@
"type": "object"
},
"Status": {
- "description": "The `Status` type defines a logical error model that is suitable for\ndifferent programming environments, including REST APIs and RPC APIs. It is\nused by [gRPC](https://github.com/grpc). The error model is designed to be:\n\n- Simple to use and understand for most users\n- Flexible enough to meet unexpected needs\n\n# Overview\n\nThe `Status` message contains three pieces of data: error code, error\nmessage, and error details. The error code should be an enum value of\ngoogle.rpc.Code, but it may accept additional error codes if needed. The\nerror message should be a developer-facing English message that helps\ndevelopers *understand* and *resolve* the error. If a localized user-facing\nerror message is needed, put the localized message in the error details or\nlocalize it in the client. The optional error details may contain arbitrary\ninformation about the error. There is a predefined set of error detail types\nin the package `google.rpc` that can be used for common error conditions.\n\n# Language mapping\n\nThe `Status` message is the logical representation of the error model, but it\nis not necessarily the actual wire format. When the `Status` message is\nexposed in different client libraries and different wire protocols, it can be\nmapped differently. For example, it will likely be mapped to some exceptions\nin Java, but more likely mapped to some error codes in C.\n\n# Other uses\n\nThe error model and the `Status` message can be used in a variety of\nenvironments, either with or without APIs, to provide a\nconsistent developer experience across different environments.\n\nExample uses of this error model include:\n\n- Partial errors. If a service needs to return partial errors to the client,\n it may embed the `Status` in the normal response to indicate the partial\n errors.\n\n- Workflow errors. A typical workflow has multiple steps. Each step may\n have a `Status` message for error reporting.\n\n- Batch operations. If a client uses batch request and batch response, the\n `Status` message should be used directly inside batch response, one for\n each error sub-response.\n\n- Asynchronous operations. If an API call embeds asynchronous operation\n results in its response, the status of those operations should be\n represented directly using the `Status` message.\n\n- Logging. If some API errors are stored in logs, the message `Status` could\n be used directly after any stripping needed for security/privacy reasons.",
+ "description": "The `Status` type defines a logical error model that is suitable for\ndifferent programming environments, including REST APIs and RPC APIs. It is\nused by [gRPC](https://github.com/grpc). Each `Status` message contains\nthree pieces of data: error code, error message, and error details.\n\nYou can find out more about this error model and how to work with it in the\n[API Design Guide](https://cloud.google.com/apis/design/errors).",
"id": "Status",
"properties": {
"code": {
diff --git a/cloudshell/v1/cloudshell-gen.go b/cloudshell/v1/cloudshell-gen.go
index c738f92..094d5dd 100644
--- a/cloudshell/v1/cloudshell-gen.go
+++ b/cloudshell/v1/cloudshell-gen.go
@@ -505,81 +505,14 @@
// suitable for
// different programming environments, including REST APIs and RPC APIs.
// It is
-// used by [gRPC](https://github.com/grpc). The error model is designed
-// to be:
+// used by [gRPC](https://github.com/grpc). Each `Status` message
+// contains
+// three pieces of data: error code, error message, and error
+// details.
//
-// - Simple to use and understand for most users
-// - Flexible enough to meet unexpected needs
-//
-// # Overview
-//
-// The `Status` message contains three pieces of data: error code,
-// error
-// message, and error details. The error code should be an enum value
-// of
-// google.rpc.Code, but it may accept additional error codes if needed.
-// The
-// error message should be a developer-facing English message that
-// helps
-// developers *understand* and *resolve* the error. If a localized
-// user-facing
-// error message is needed, put the localized message in the error
-// details or
-// localize it in the client. The optional error details may contain
-// arbitrary
-// information about the error. There is a predefined set of error
-// detail types
-// in the package `google.rpc` that can be used for common error
-// conditions.
-//
-// # Language mapping
-//
-// The `Status` message is the logical representation of the error
-// model, but it
-// is not necessarily the actual wire format. When the `Status` message
-// is
-// exposed in different client libraries and different wire protocols,
-// it can be
-// mapped differently. For example, it will likely be mapped to some
-// exceptions
-// in Java, but more likely mapped to some error codes in C.
-//
-// # Other uses
-//
-// The error model and the `Status` message can be used in a variety
-// of
-// environments, either with or without APIs, to provide a
-// consistent developer experience across different
-// environments.
-//
-// Example uses of this error model include:
-//
-// - Partial errors. If a service needs to return partial errors to the
-// client,
-// it may embed the `Status` in the normal response to indicate the
-// partial
-// errors.
-//
-// - Workflow errors. A typical workflow has multiple steps. Each step
-// may
-// have a `Status` message for error reporting.
-//
-// - Batch operations. If a client uses batch request and batch
-// response, the
-// `Status` message should be used directly inside batch response,
-// one for
-// each error sub-response.
-//
-// - Asynchronous operations. If an API call embeds asynchronous
-// operation
-// results in its response, the status of those operations should
-// be
-// represented directly using the `Status` message.
-//
-// - Logging. If some API errors are stored in logs, the message
-// `Status` could
-// be used directly after any stripping needed for security/privacy
-// reasons.
+// 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 Status struct {
// Code: The status code, which should be an enum value of
// google.rpc.Code.
diff --git a/cloudshell/v1alpha1/cloudshell-api.json b/cloudshell/v1alpha1/cloudshell-api.json
index f5cfed1..2141460 100644
--- a/cloudshell/v1alpha1/cloudshell-api.json
+++ b/cloudshell/v1alpha1/cloudshell-api.json
@@ -287,7 +287,7 @@
}
}
},
- "revision": "20190514",
+ "revision": "20190610",
"rootUrl": "https://cloudshell.googleapis.com/",
"schemas": {
"AuthorizeEnvironmentRequest": {
@@ -499,7 +499,7 @@
"type": "object"
},
"Status": {
- "description": "The `Status` type defines a logical error model that is suitable for\ndifferent programming environments, including REST APIs and RPC APIs. It is\nused by [gRPC](https://github.com/grpc). The error model is designed to be:\n\n- Simple to use and understand for most users\n- Flexible enough to meet unexpected needs\n\n# Overview\n\nThe `Status` message contains three pieces of data: error code, error\nmessage, and error details. The error code should be an enum value of\ngoogle.rpc.Code, but it may accept additional error codes if needed. The\nerror message should be a developer-facing English message that helps\ndevelopers *understand* and *resolve* the error. If a localized user-facing\nerror message is needed, put the localized message in the error details or\nlocalize it in the client. The optional error details may contain arbitrary\ninformation about the error. There is a predefined set of error detail types\nin the package `google.rpc` that can be used for common error conditions.\n\n# Language mapping\n\nThe `Status` message is the logical representation of the error model, but it\nis not necessarily the actual wire format. When the `Status` message is\nexposed in different client libraries and different wire protocols, it can be\nmapped differently. For example, it will likely be mapped to some exceptions\nin Java, but more likely mapped to some error codes in C.\n\n# Other uses\n\nThe error model and the `Status` message can be used in a variety of\nenvironments, either with or without APIs, to provide a\nconsistent developer experience across different environments.\n\nExample uses of this error model include:\n\n- Partial errors. If a service needs to return partial errors to the client,\n it may embed the `Status` in the normal response to indicate the partial\n errors.\n\n- Workflow errors. A typical workflow has multiple steps. Each step may\n have a `Status` message for error reporting.\n\n- Batch operations. If a client uses batch request and batch response, the\n `Status` message should be used directly inside batch response, one for\n each error sub-response.\n\n- Asynchronous operations. If an API call embeds asynchronous operation\n results in its response, the status of those operations should be\n represented directly using the `Status` message.\n\n- Logging. If some API errors are stored in logs, the message `Status` could\n be used directly after any stripping needed for security/privacy reasons.",
+ "description": "The `Status` type defines a logical error model that is suitable for\ndifferent programming environments, including REST APIs and RPC APIs. It is\nused by [gRPC](https://github.com/grpc). Each `Status` message contains\nthree pieces of data: error code, error message, and error details.\n\nYou can find out more about this error model and how to work with it in the\n[API Design Guide](https://cloud.google.com/apis/design/errors).",
"id": "Status",
"properties": {
"code": {
diff --git a/cloudshell/v1alpha1/cloudshell-gen.go b/cloudshell/v1alpha1/cloudshell-gen.go
index 7a0f80c..14baca5 100644
--- a/cloudshell/v1alpha1/cloudshell-gen.go
+++ b/cloudshell/v1alpha1/cloudshell-gen.go
@@ -595,81 +595,14 @@
// suitable for
// different programming environments, including REST APIs and RPC APIs.
// It is
-// used by [gRPC](https://github.com/grpc). The error model is designed
-// to be:
+// used by [gRPC](https://github.com/grpc). Each `Status` message
+// contains
+// three pieces of data: error code, error message, and error
+// details.
//
-// - Simple to use and understand for most users
-// - Flexible enough to meet unexpected needs
-//
-// # Overview
-//
-// The `Status` message contains three pieces of data: error code,
-// error
-// message, and error details. The error code should be an enum value
-// of
-// google.rpc.Code, but it may accept additional error codes if needed.
-// The
-// error message should be a developer-facing English message that
-// helps
-// developers *understand* and *resolve* the error. If a localized
-// user-facing
-// error message is needed, put the localized message in the error
-// details or
-// localize it in the client. The optional error details may contain
-// arbitrary
-// information about the error. There is a predefined set of error
-// detail types
-// in the package `google.rpc` that can be used for common error
-// conditions.
-//
-// # Language mapping
-//
-// The `Status` message is the logical representation of the error
-// model, but it
-// is not necessarily the actual wire format. When the `Status` message
-// is
-// exposed in different client libraries and different wire protocols,
-// it can be
-// mapped differently. For example, it will likely be mapped to some
-// exceptions
-// in Java, but more likely mapped to some error codes in C.
-//
-// # Other uses
-//
-// The error model and the `Status` message can be used in a variety
-// of
-// environments, either with or without APIs, to provide a
-// consistent developer experience across different
-// environments.
-//
-// Example uses of this error model include:
-//
-// - Partial errors. If a service needs to return partial errors to the
-// client,
-// it may embed the `Status` in the normal response to indicate the
-// partial
-// errors.
-//
-// - Workflow errors. A typical workflow has multiple steps. Each step
-// may
-// have a `Status` message for error reporting.
-//
-// - Batch operations. If a client uses batch request and batch
-// response, the
-// `Status` message should be used directly inside batch response,
-// one for
-// each error sub-response.
-//
-// - Asynchronous operations. If an API call embeds asynchronous
-// operation
-// results in its response, the status of those operations should
-// be
-// represented directly using the `Status` message.
-//
-// - Logging. If some API errors are stored in logs, the message
-// `Status` could
-// be used directly after any stripping needed for security/privacy
-// reasons.
+// 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 Status struct {
// Code: The status code, which should be an enum value of
// google.rpc.Code.
diff --git a/dataproc/v1/dataproc-api.json b/dataproc/v1/dataproc-api.json
index 7d991c3..120a432 100644
--- a/dataproc/v1/dataproc-api.json
+++ b/dataproc/v1/dataproc-api.json
@@ -1810,7 +1810,7 @@
}
}
},
- "revision": "20190523",
+ "revision": "20190606",
"rootUrl": "https://dataproc.googleapis.com/",
"schemas": {
"AcceleratorConfig": {
@@ -3245,7 +3245,7 @@
"type": "object"
},
"Status": {
- "description": "The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be:\nSimple to use and understand for most users\nFlexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc that can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include:\nPartial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors.\nWorkflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting.\nBatch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response.\nAsynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message.\nLogging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons.",
+ "description": "The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each Status message contains three pieces of data: error code, error message, and error details.You can find out more about this error model and how to work with it in the API Design Guide (https://cloud.google.com/apis/design/errors).",
"id": "Status",
"properties": {
"code": {
diff --git a/dataproc/v1/dataproc-gen.go b/dataproc/v1/dataproc-gen.go
index 914d68b..4794ed9 100644
--- a/dataproc/v1/dataproc-gen.go
+++ b/dataproc/v1/dataproc-gen.go
@@ -2611,43 +2611,11 @@
// Status: The Status type defines a logical error model that is
// suitable for different programming environments, including REST APIs
-// and RPC APIs. It is used by gRPC (https://github.com/grpc). The error
-// model is designed to be:
-// Simple to use and understand for most users
-// Flexible enough to meet unexpected needsOverviewThe Status message
-// contains three pieces of data: error code, error message, and error
-// details. The error code should be an enum value of google.rpc.Code,
-// but it may accept additional error codes if needed. The error message
-// should be a developer-facing English message that helps developers
-// understand and resolve the error. If a localized user-facing error
-// message is needed, put the localized message in the error details or
-// localize it in the client. The optional error details may contain
-// arbitrary information about the error. There is a predefined set of
-// error detail types in the package google.rpc that can be used for
-// common error conditions.Language mappingThe Status message is the
-// logical representation of the error model, but it is not necessarily
-// the actual wire format. When the Status message is exposed in
-// different client libraries and different wire protocols, it can be
-// mapped differently. For example, it will likely be mapped to some
-// exceptions in Java, but more likely mapped to some error codes in
-// C.Other usesThe error model and the Status message can be used in a
-// variety of environments, either with or without APIs, to provide a
-// consistent developer experience across different environments.Example
-// uses of this error model include:
-// Partial errors. If a service needs to return partial errors to the
-// client, it may embed the Status in the normal response to indicate
-// the partial errors.
-// Workflow errors. A typical workflow has multiple steps. Each step may
-// have a Status message for error reporting.
-// Batch operations. If a client uses batch request and batch response,
-// the Status message should be used directly inside batch response, one
-// for each error sub-response.
-// Asynchronous operations. If an API call embeds asynchronous operation
-// results in its response, the status of those operations should be
-// represented directly using the Status message.
-// Logging. If some API errors are stored in logs, the message Status
-// could be used directly after any stripping needed for
-// security/privacy reasons.
+// 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 Status struct {
// Code: The status code, which should be an enum value of
// google.rpc.Code.
diff --git a/dataproc/v1beta2/dataproc-api.json b/dataproc/v1beta2/dataproc-api.json
index 3ec7679..bb0e6d0 100644
--- a/dataproc/v1beta2/dataproc-api.json
+++ b/dataproc/v1beta2/dataproc-api.json
@@ -2083,7 +2083,7 @@
}
}
},
- "revision": "20190523",
+ "revision": "20190606",
"rootUrl": "https://dataproc.googleapis.com/",
"schemas": {
"AcceleratorConfig": {
@@ -3845,7 +3845,7 @@
"type": "object"
},
"Status": {
- "description": "The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be:\nSimple to use and understand for most users\nFlexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc that can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include:\nPartial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors.\nWorkflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting.\nBatch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response.\nAsynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message.\nLogging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons.",
+ "description": "The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each Status message contains three pieces of data: error code, error message, and error details.You can find out more about this error model and how to work with it in the API Design Guide (https://cloud.google.com/apis/design/errors).",
"id": "Status",
"properties": {
"code": {
diff --git a/dataproc/v1beta2/dataproc-gen.go b/dataproc/v1beta2/dataproc-gen.go
index 6e04acc..67f33b9 100644
--- a/dataproc/v1beta2/dataproc-gen.go
+++ b/dataproc/v1beta2/dataproc-gen.go
@@ -3184,43 +3184,11 @@
// Status: The Status type defines a logical error model that is
// suitable for different programming environments, including REST APIs
-// and RPC APIs. It is used by gRPC (https://github.com/grpc). The error
-// model is designed to be:
-// Simple to use and understand for most users
-// Flexible enough to meet unexpected needsOverviewThe Status message
-// contains three pieces of data: error code, error message, and error
-// details. The error code should be an enum value of google.rpc.Code,
-// but it may accept additional error codes if needed. The error message
-// should be a developer-facing English message that helps developers
-// understand and resolve the error. If a localized user-facing error
-// message is needed, put the localized message in the error details or
-// localize it in the client. The optional error details may contain
-// arbitrary information about the error. There is a predefined set of
-// error detail types in the package google.rpc that can be used for
-// common error conditions.Language mappingThe Status message is the
-// logical representation of the error model, but it is not necessarily
-// the actual wire format. When the Status message is exposed in
-// different client libraries and different wire protocols, it can be
-// mapped differently. For example, it will likely be mapped to some
-// exceptions in Java, but more likely mapped to some error codes in
-// C.Other usesThe error model and the Status message can be used in a
-// variety of environments, either with or without APIs, to provide a
-// consistent developer experience across different environments.Example
-// uses of this error model include:
-// Partial errors. If a service needs to return partial errors to the
-// client, it may embed the Status in the normal response to indicate
-// the partial errors.
-// Workflow errors. A typical workflow has multiple steps. Each step may
-// have a Status message for error reporting.
-// Batch operations. If a client uses batch request and batch response,
-// the Status message should be used directly inside batch response, one
-// for each error sub-response.
-// Asynchronous operations. If an API call embeds asynchronous operation
-// results in its response, the status of those operations should be
-// represented directly using the Status message.
-// Logging. If some API errors are stored in logs, the message Status
-// could be used directly after any stripping needed for
-// security/privacy reasons.
+// 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 Status struct {
// Code: The status code, which should be an enum value of
// google.rpc.Code.
diff --git a/dialogflow/v2/dialogflow-api.json b/dialogflow/v2/dialogflow-api.json
index 27051f5..89b8c01 100644
--- a/dialogflow/v2/dialogflow-api.json
+++ b/dialogflow/v2/dialogflow-api.json
@@ -109,6 +109,67 @@
"resources": {
"projects": {
"methods": {
+ "agent": {
+ "description": "Creates/updates the specified agent.",
+ "flatPath": "v2/projects/{projectsId}/agent",
+ "httpMethod": "POST",
+ "id": "dialogflow.projects.agent",
+ "parameterOrder": [
+ "parent"
+ ],
+ "parameters": {
+ "parent": {
+ "description": "Required. The project of this agent.\nFormat: `projects/\u003cProject ID\u003e`.",
+ "location": "path",
+ "pattern": "^projects/[^/]+$",
+ "required": true,
+ "type": "string"
+ },
+ "updateMask": {
+ "description": "Optional. The mask to control which fields get updated.",
+ "format": "google-fieldmask",
+ "location": "query",
+ "type": "string"
+ }
+ },
+ "path": "v2/{+parent}/agent",
+ "request": {
+ "$ref": "GoogleCloudDialogflowV2Agent"
+ },
+ "response": {
+ "$ref": "GoogleCloudDialogflowV2Agent"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/cloud-platform",
+ "https://www.googleapis.com/auth/dialogflow"
+ ]
+ },
+ "deleteAgent": {
+ "description": "Deletes the specified agent.",
+ "flatPath": "v2/projects/{projectsId}/agent",
+ "httpMethod": "DELETE",
+ "id": "dialogflow.projects.deleteAgent",
+ "parameterOrder": [
+ "parent"
+ ],
+ "parameters": {
+ "parent": {
+ "description": "Required. The project that the agent to delete is associated with.\nFormat: `projects/\u003cProject ID\u003e`.",
+ "location": "path",
+ "pattern": "^projects/[^/]+$",
+ "required": true,
+ "type": "string"
+ }
+ },
+ "path": "v2/{+parent}/agent",
+ "response": {
+ "$ref": "GoogleProtobufEmpty"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/cloud-platform",
+ "https://www.googleapis.com/auth/dialogflow"
+ ]
+ },
"getAgent": {
"description": "Retrieves the specified agent.",
"flatPath": "v2/projects/{projectsId}/agent",
@@ -1303,13 +1364,29 @@
}
}
},
- "revision": "20190601",
+ "revision": "20190610",
"rootUrl": "https://dialogflow.googleapis.com/",
"schemas": {
"GoogleCloudDialogflowV2Agent": {
"description": "Represents a conversational agent.",
"id": "GoogleCloudDialogflowV2Agent",
"properties": {
+ "apiVersion": {
+ "description": "Optional. API version displayed in Dialogflow console. If not specified,\nV2 API is assumed. Clients are free to query different service endpoints\nfor different API versions. However, bots connectors and webhook calls will\nfollow the specified API version.",
+ "enum": [
+ "API_VERSION_UNSPECIFIED",
+ "API_VERSION_V1",
+ "API_VERSION_V2",
+ "API_VERSION_V2_BETA_1"
+ ],
+ "enumDescriptions": [
+ "Not specified.",
+ "Legacy V1 API.",
+ "V2 API.",
+ "V2beta1 API."
+ ],
+ "type": "string"
+ },
"avatarUri": {
"description": "Optional. The URI of the agent's avatar.\nAvatars are used throughout the Dialogflow console and in the self-hosted\n[Web\nDemo](https://cloud.google.com/dialogflow-enterprise/docs/integrations/web-demo)\nintegration.",
"type": "string"
@@ -1360,6 +1437,22 @@
},
"type": "array"
},
+ "tier": {
+ "description": "Optional. The agent tier. If not specified, TIER_STANDARD is assumed.",
+ "enum": [
+ "TIER_UNSPECIFIED",
+ "TIER_STANDARD",
+ "TIER_ENTERPRISE",
+ "TIER_ENTERPRISE_PLUS"
+ ],
+ "enumDescriptions": [
+ "Not specified. This value should never be used.",
+ "Standard tier.",
+ "Enterprise tier (Essentials).",
+ "Enterprise tier (Plus)."
+ ],
+ "type": "string"
+ },
"timeZone": {
"description": "Required. The time zone of this agent from the\n[time zone database](https://www.iana.org/time-zones), e.g.,\nAmerica/New_York, Europe/Paris.",
"type": "string"
diff --git a/dialogflow/v2/dialogflow-gen.go b/dialogflow/v2/dialogflow-gen.go
index 3463a92..1067e44 100644
--- a/dialogflow/v2/dialogflow-gen.go
+++ b/dialogflow/v2/dialogflow-gen.go
@@ -142,7 +142,7 @@
func NewProjectsService(s *Service) *ProjectsService {
rs := &ProjectsService{s: s}
- rs.Agent = NewProjectsAgentService(s)
+ rs.Agent_ = NewProjectsAgentService(s)
rs.Operations = NewProjectsOperationsService(s)
return rs
}
@@ -150,7 +150,7 @@
type ProjectsService struct {
s *Service
- Agent *ProjectsAgentService
+ Agent_ *ProjectsAgentService
Operations *ProjectsOperationsService
}
@@ -247,6 +247,21 @@
// GoogleCloudDialogflowV2Agent: Represents a conversational agent.
type GoogleCloudDialogflowV2Agent struct {
+ // ApiVersion: Optional. API version displayed in Dialogflow console. If
+ // not specified,
+ // V2 API is assumed. Clients are free to query different service
+ // endpoints
+ // for different API versions. However, bots connectors and webhook
+ // calls will
+ // follow the specified API version.
+ //
+ // Possible values:
+ // "API_VERSION_UNSPECIFIED" - Not specified.
+ // "API_VERSION_V1" - Legacy V1 API.
+ // "API_VERSION_V2" - V2 API.
+ // "API_VERSION_V2_BETA_1" - V2beta1 API.
+ ApiVersion string `json:"apiVersion,omitempty"`
+
// AvatarUri: Optional. The URI of the agent's avatar.
// Avatars are used throughout the Dialogflow console and in the
// self-hosted
@@ -316,6 +331,17 @@
// `default_language_code`).
SupportedLanguageCodes []string `json:"supportedLanguageCodes,omitempty"`
+ // Tier: Optional. The agent tier. If not specified, TIER_STANDARD is
+ // assumed.
+ //
+ // Possible values:
+ // "TIER_UNSPECIFIED" - Not specified. This value should never be
+ // used.
+ // "TIER_STANDARD" - Standard tier.
+ // "TIER_ENTERPRISE" - Enterprise tier (Essentials).
+ // "TIER_ENTERPRISE_PLUS" - Enterprise tier (Plus).
+ Tier string `json:"tier,omitempty"`
+
// TimeZone: Required. The time zone of this agent from the
// [time zone database](https://www.iana.org/time-zones),
// e.g.,
@@ -326,7 +352,7 @@
// server.
googleapi.ServerResponse `json:"-"`
- // ForceSendFields is a list of field names (e.g. "AvatarUri") to
+ // ForceSendFields is a list of field names (e.g. "ApiVersion") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
@@ -334,7 +360,7 @@
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
- // NullFields is a list of field names (e.g. "AvatarUri") to include in
+ // 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
@@ -6371,6 +6397,289 @@
return nil
}
+// method id "dialogflow.projects.agent":
+
+type ProjectsAgentCall struct {
+ s *Service
+ parent string
+ googleclouddialogflowv2agent *GoogleCloudDialogflowV2Agent
+ urlParams_ gensupport.URLParams
+ ctx_ context.Context
+ header_ http.Header
+}
+
+// Agent: Creates/updates the specified agent.
+func (r *ProjectsService) Agent(parent string, googleclouddialogflowv2agent *GoogleCloudDialogflowV2Agent) *ProjectsAgentCall {
+ c := &ProjectsAgentCall{s: r.s, urlParams_: make(gensupport.URLParams)}
+ c.parent = parent
+ c.googleclouddialogflowv2agent = googleclouddialogflowv2agent
+ return c
+}
+
+// UpdateMask sets the optional parameter "updateMask": The mask to
+// control which fields get updated.
+func (c *ProjectsAgentCall) UpdateMask(updateMask string) *ProjectsAgentCall {
+ 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 *ProjectsAgentCall) Fields(s ...googleapi.Field) *ProjectsAgentCall {
+ 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 *ProjectsAgentCall) Context(ctx context.Context) *ProjectsAgentCall {
+ 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 *ProjectsAgentCall) Header() http.Header {
+ if c.header_ == nil {
+ c.header_ = make(http.Header)
+ }
+ return c.header_
+}
+
+func (c *ProjectsAgentCall) doRequest(alt string) (*http.Response, error) {
+ reqHeaders := make(http.Header)
+ 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.googleclouddialogflowv2agent)
+ 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/{+parent}/agent")
+ 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 "dialogflow.projects.agent" call.
+// Exactly one of *GoogleCloudDialogflowV2Agent or error will be
+// non-nil. Any non-2xx status code is an error. Response headers are in
+// either *GoogleCloudDialogflowV2Agent.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 *ProjectsAgentCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDialogflowV2Agent, 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 := &GoogleCloudDialogflowV2Agent{
+ 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/updates the specified agent.",
+ // "flatPath": "v2/projects/{projectsId}/agent",
+ // "httpMethod": "POST",
+ // "id": "dialogflow.projects.agent",
+ // "parameterOrder": [
+ // "parent"
+ // ],
+ // "parameters": {
+ // "parent": {
+ // "description": "Required. The project of this agent.\nFormat: `projects/\u003cProject ID\u003e`.",
+ // "location": "path",
+ // "pattern": "^projects/[^/]+$",
+ // "required": true,
+ // "type": "string"
+ // },
+ // "updateMask": {
+ // "description": "Optional. The mask to control which fields get updated.",
+ // "format": "google-fieldmask",
+ // "location": "query",
+ // "type": "string"
+ // }
+ // },
+ // "path": "v2/{+parent}/agent",
+ // "request": {
+ // "$ref": "GoogleCloudDialogflowV2Agent"
+ // },
+ // "response": {
+ // "$ref": "GoogleCloudDialogflowV2Agent"
+ // },
+ // "scopes": [
+ // "https://www.googleapis.com/auth/cloud-platform",
+ // "https://www.googleapis.com/auth/dialogflow"
+ // ]
+ // }
+
+}
+
+// method id "dialogflow.projects.deleteAgent":
+
+type ProjectsDeleteAgentCall struct {
+ s *Service
+ parent string
+ urlParams_ gensupport.URLParams
+ ctx_ context.Context
+ header_ http.Header
+}
+
+// DeleteAgent: Deletes the specified agent.
+func (r *ProjectsService) DeleteAgent(parent string) *ProjectsDeleteAgentCall {
+ c := &ProjectsDeleteAgentCall{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 *ProjectsDeleteAgentCall) Fields(s ...googleapi.Field) *ProjectsDeleteAgentCall {
+ 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 *ProjectsDeleteAgentCall) Context(ctx context.Context) *ProjectsDeleteAgentCall {
+ 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 *ProjectsDeleteAgentCall) Header() http.Header {
+ if c.header_ == nil {
+ c.header_ = make(http.Header)
+ }
+ return c.header_
+}
+
+func (c *ProjectsDeleteAgentCall) doRequest(alt string) (*http.Response, error) {
+ reqHeaders := make(http.Header)
+ 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, "v2/{+parent}/agent")
+ 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{
+ "parent": c.parent,
+ })
+ return gensupport.SendRequest(c.ctx_, c.s.client, req)
+}
+
+// Do executes the "dialogflow.projects.deleteAgent" call.
+// Exactly one of *GoogleProtobufEmpty or error will be non-nil. Any
+// non-2xx status code is an error. Response headers are in either
+// *GoogleProtobufEmpty.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 *ProjectsDeleteAgentCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, 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 := &GoogleProtobufEmpty{
+ 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 specified agent.",
+ // "flatPath": "v2/projects/{projectsId}/agent",
+ // "httpMethod": "DELETE",
+ // "id": "dialogflow.projects.deleteAgent",
+ // "parameterOrder": [
+ // "parent"
+ // ],
+ // "parameters": {
+ // "parent": {
+ // "description": "Required. The project that the agent to delete is associated with.\nFormat: `projects/\u003cProject ID\u003e`.",
+ // "location": "path",
+ // "pattern": "^projects/[^/]+$",
+ // "required": true,
+ // "type": "string"
+ // }
+ // },
+ // "path": "v2/{+parent}/agent",
+ // "response": {
+ // "$ref": "GoogleProtobufEmpty"
+ // },
+ // "scopes": [
+ // "https://www.googleapis.com/auth/cloud-platform",
+ // "https://www.googleapis.com/auth/dialogflow"
+ // ]
+ // }
+
+}
+
// method id "dialogflow.projects.getAgent":
type ProjectsGetAgentCall struct {
diff --git a/dialogflow/v2beta1/dialogflow-api.json b/dialogflow/v2beta1/dialogflow-api.json
index f5c1935..10ec061 100644
--- a/dialogflow/v2beta1/dialogflow-api.json
+++ b/dialogflow/v2beta1/dialogflow-api.json
@@ -109,6 +109,67 @@
"resources": {
"projects": {
"methods": {
+ "agent": {
+ "description": "Creates/updates the specified agent.",
+ "flatPath": "v2beta1/projects/{projectsId}/agent",
+ "httpMethod": "POST",
+ "id": "dialogflow.projects.agent",
+ "parameterOrder": [
+ "parent"
+ ],
+ "parameters": {
+ "parent": {
+ "description": "Required. The project of this agent.\nFormat: `projects/\u003cProject ID\u003e`.",
+ "location": "path",
+ "pattern": "^projects/[^/]+$",
+ "required": true,
+ "type": "string"
+ },
+ "updateMask": {
+ "description": "Optional. The mask to control which fields get updated.",
+ "format": "google-fieldmask",
+ "location": "query",
+ "type": "string"
+ }
+ },
+ "path": "v2beta1/{+parent}/agent",
+ "request": {
+ "$ref": "GoogleCloudDialogflowV2beta1Agent"
+ },
+ "response": {
+ "$ref": "GoogleCloudDialogflowV2beta1Agent"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/cloud-platform",
+ "https://www.googleapis.com/auth/dialogflow"
+ ]
+ },
+ "deleteAgent": {
+ "description": "Deletes the specified agent.",
+ "flatPath": "v2beta1/projects/{projectsId}/agent",
+ "httpMethod": "DELETE",
+ "id": "dialogflow.projects.deleteAgent",
+ "parameterOrder": [
+ "parent"
+ ],
+ "parameters": {
+ "parent": {
+ "description": "Required. The project that the agent to delete is associated with.\nFormat: `projects/\u003cProject ID\u003e`.",
+ "location": "path",
+ "pattern": "^projects/[^/]+$",
+ "required": true,
+ "type": "string"
+ }
+ },
+ "path": "v2beta1/{+parent}/agent",
+ "response": {
+ "$ref": "GoogleProtobufEmpty"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/cloud-platform",
+ "https://www.googleapis.com/auth/dialogflow"
+ ]
+ },
"getAgent": {
"description": "Retrieves the specified agent.",
"flatPath": "v2beta1/projects/{projectsId}/agent",
@@ -2386,7 +2447,7 @@
}
}
},
- "revision": "20190601",
+ "revision": "20190610",
"rootUrl": "https://dialogflow.googleapis.com/",
"schemas": {
"GoogleCloudDialogflowV2BatchUpdateEntityTypesResponse": {
@@ -3403,6 +3464,22 @@
"description": "Represents a conversational agent.",
"id": "GoogleCloudDialogflowV2beta1Agent",
"properties": {
+ "apiVersion": {
+ "description": "Optional. API version displayed in Dialogflow console. If not specified,\nV2 API is assumed. Clients are free to query different service endpoints\nfor different API versions. However, bots connectors and webhook calls will\nfollow the specified API version.",
+ "enum": [
+ "API_VERSION_UNSPECIFIED",
+ "API_VERSION_V1",
+ "API_VERSION_V2",
+ "API_VERSION_V2_BETA_1"
+ ],
+ "enumDescriptions": [
+ "Not specified.",
+ "Legacy V1 API.",
+ "V2 API.",
+ "V2beta1 API."
+ ],
+ "type": "string"
+ },
"avatarUri": {
"description": "Optional. The URI of the agent's avatar.\nAvatars are used throughout the Dialogflow console and in the self-hosted\n[Web\nDemo](https://cloud.google.com/dialogflow-enterprise/docs/integrations/web-demo)\nintegration.",
"type": "string"
@@ -3453,6 +3530,22 @@
},
"type": "array"
},
+ "tier": {
+ "description": "Optional. The agent tier. If not specified, TIER_STANDARD is assumed.",
+ "enum": [
+ "TIER_UNSPECIFIED",
+ "TIER_STANDARD",
+ "TIER_ENTERPRISE",
+ "TIER_ENTERPRISE_PLUS"
+ ],
+ "enumDescriptions": [
+ "Not specified. This value should never be used.",
+ "Standard tier.",
+ "Enterprise tier (Essentials).",
+ "Enterprise tier (Plus)."
+ ],
+ "type": "string"
+ },
"timeZone": {
"description": "Required. The time zone of this agent from the\n[time zone database](https://www.iana.org/time-zones), e.g.,\nAmerica/New_York, Europe/Paris.",
"type": "string"
@@ -3701,7 +3794,7 @@
},
"outputAudioConfig": {
"$ref": "GoogleCloudDialogflowV2beta1OutputAudioConfig",
- "description": "Instructs the speech synthesizer how to generate the output audio. This\nfield is populated from the agent-level speech synthesizer configuration,\nif enabled."
+ "description": "The config used by the speech synthesizer to generate the output audio."
},
"queryResult": {
"$ref": "GoogleCloudDialogflowV2beta1QueryResult",
diff --git a/dialogflow/v2beta1/dialogflow-gen.go b/dialogflow/v2beta1/dialogflow-gen.go
index c70ef94..dbac60b 100644
--- a/dialogflow/v2beta1/dialogflow-gen.go
+++ b/dialogflow/v2beta1/dialogflow-gen.go
@@ -142,7 +142,7 @@
func NewProjectsService(s *Service) *ProjectsService {
rs := &ProjectsService{s: s}
- rs.Agent = NewProjectsAgentService(s)
+ rs.Agent_ = NewProjectsAgentService(s)
rs.KnowledgeBases = NewProjectsKnowledgeBasesService(s)
rs.Operations = NewProjectsOperationsService(s)
return rs
@@ -151,7 +151,7 @@
type ProjectsService struct {
s *Service
- Agent *ProjectsAgentService
+ Agent_ *ProjectsAgentService
KnowledgeBases *ProjectsKnowledgeBasesService
@@ -2360,6 +2360,21 @@
// GoogleCloudDialogflowV2beta1Agent: Represents a conversational agent.
type GoogleCloudDialogflowV2beta1Agent struct {
+ // ApiVersion: Optional. API version displayed in Dialogflow console. If
+ // not specified,
+ // V2 API is assumed. Clients are free to query different service
+ // endpoints
+ // for different API versions. However, bots connectors and webhook
+ // calls will
+ // follow the specified API version.
+ //
+ // Possible values:
+ // "API_VERSION_UNSPECIFIED" - Not specified.
+ // "API_VERSION_V1" - Legacy V1 API.
+ // "API_VERSION_V2" - V2 API.
+ // "API_VERSION_V2_BETA_1" - V2beta1 API.
+ ApiVersion string `json:"apiVersion,omitempty"`
+
// AvatarUri: Optional. The URI of the agent's avatar.
// Avatars are used throughout the Dialogflow console and in the
// self-hosted
@@ -2429,6 +2444,17 @@
// `default_language_code`).
SupportedLanguageCodes []string `json:"supportedLanguageCodes,omitempty"`
+ // Tier: Optional. The agent tier. If not specified, TIER_STANDARD is
+ // assumed.
+ //
+ // Possible values:
+ // "TIER_UNSPECIFIED" - Not specified. This value should never be
+ // used.
+ // "TIER_STANDARD" - Standard tier.
+ // "TIER_ENTERPRISE" - Enterprise tier (Essentials).
+ // "TIER_ENTERPRISE_PLUS" - Enterprise tier (Plus).
+ Tier string `json:"tier,omitempty"`
+
// TimeZone: Required. The time zone of this agent from the
// [time zone database](https://www.iana.org/time-zones),
// e.g.,
@@ -2439,7 +2465,7 @@
// server.
googleapi.ServerResponse `json:"-"`
- // ForceSendFields is a list of field names (e.g. "AvatarUri") to
+ // ForceSendFields is a list of field names (e.g. "ApiVersion") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
@@ -2447,7 +2473,7 @@
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
- // NullFields is a list of field names (e.g. "AvatarUri") to include in
+ // 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
@@ -2997,11 +3023,8 @@
// generated audio content will be empty.
OutputAudio string `json:"outputAudio,omitempty"`
- // OutputAudioConfig: Instructs the speech synthesizer how to generate
- // the output audio. This
- // field is populated from the agent-level speech synthesizer
- // configuration,
- // if enabled.
+ // OutputAudioConfig: The config used by the speech synthesizer to
+ // generate the output audio.
OutputAudioConfig *GoogleCloudDialogflowV2beta1OutputAudioConfig `json:"outputAudioConfig,omitempty"`
// QueryResult: The selected results of the conversational query or
@@ -6771,6 +6794,290 @@
return nil
}
+// method id "dialogflow.projects.agent":
+
+type ProjectsAgentCall struct {
+ s *Service
+ parent string
+ googleclouddialogflowv2beta1agent *GoogleCloudDialogflowV2beta1Agent
+ urlParams_ gensupport.URLParams
+ ctx_ context.Context
+ header_ http.Header
+}
+
+// Agent: Creates/updates the specified agent.
+func (r *ProjectsService) Agent(parent string, googleclouddialogflowv2beta1agent *GoogleCloudDialogflowV2beta1Agent) *ProjectsAgentCall {
+ c := &ProjectsAgentCall{s: r.s, urlParams_: make(gensupport.URLParams)}
+ c.parent = parent
+ c.googleclouddialogflowv2beta1agent = googleclouddialogflowv2beta1agent
+ return c
+}
+
+// UpdateMask sets the optional parameter "updateMask": The mask to
+// control which fields get updated.
+func (c *ProjectsAgentCall) UpdateMask(updateMask string) *ProjectsAgentCall {
+ 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 *ProjectsAgentCall) Fields(s ...googleapi.Field) *ProjectsAgentCall {
+ 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 *ProjectsAgentCall) Context(ctx context.Context) *ProjectsAgentCall {
+ 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 *ProjectsAgentCall) Header() http.Header {
+ if c.header_ == nil {
+ c.header_ = make(http.Header)
+ }
+ return c.header_
+}
+
+func (c *ProjectsAgentCall) doRequest(alt string) (*http.Response, error) {
+ reqHeaders := make(http.Header)
+ 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.googleclouddialogflowv2beta1agent)
+ 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, "v2beta1/{+parent}/agent")
+ 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 "dialogflow.projects.agent" call.
+// Exactly one of *GoogleCloudDialogflowV2beta1Agent or error will be
+// non-nil. Any non-2xx status code is an error. Response headers are in
+// either *GoogleCloudDialogflowV2beta1Agent.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 *ProjectsAgentCall) Do(opts ...googleapi.CallOption) (*GoogleCloudDialogflowV2beta1Agent, 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 := &GoogleCloudDialogflowV2beta1Agent{
+ 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/updates the specified agent.",
+ // "flatPath": "v2beta1/projects/{projectsId}/agent",
+ // "httpMethod": "POST",
+ // "id": "dialogflow.projects.agent",
+ // "parameterOrder": [
+ // "parent"
+ // ],
+ // "parameters": {
+ // "parent": {
+ // "description": "Required. The project of this agent.\nFormat: `projects/\u003cProject ID\u003e`.",
+ // "location": "path",
+ // "pattern": "^projects/[^/]+$",
+ // "required": true,
+ // "type": "string"
+ // },
+ // "updateMask": {
+ // "description": "Optional. The mask to control which fields get updated.",
+ // "format": "google-fieldmask",
+ // "location": "query",
+ // "type": "string"
+ // }
+ // },
+ // "path": "v2beta1/{+parent}/agent",
+ // "request": {
+ // "$ref": "GoogleCloudDialogflowV2beta1Agent"
+ // },
+ // "response": {
+ // "$ref": "GoogleCloudDialogflowV2beta1Agent"
+ // },
+ // "scopes": [
+ // "https://www.googleapis.com/auth/cloud-platform",
+ // "https://www.googleapis.com/auth/dialogflow"
+ // ]
+ // }
+
+}
+
+// method id "dialogflow.projects.deleteAgent":
+
+type ProjectsDeleteAgentCall struct {
+ s *Service
+ parent string
+ urlParams_ gensupport.URLParams
+ ctx_ context.Context
+ header_ http.Header
+}
+
+// DeleteAgent: Deletes the specified agent.
+func (r *ProjectsService) DeleteAgent(parent string) *ProjectsDeleteAgentCall {
+ c := &ProjectsDeleteAgentCall{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 *ProjectsDeleteAgentCall) Fields(s ...googleapi.Field) *ProjectsDeleteAgentCall {
+ 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 *ProjectsDeleteAgentCall) Context(ctx context.Context) *ProjectsDeleteAgentCall {
+ 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 *ProjectsDeleteAgentCall) Header() http.Header {
+ if c.header_ == nil {
+ c.header_ = make(http.Header)
+ }
+ return c.header_
+}
+
+func (c *ProjectsDeleteAgentCall) doRequest(alt string) (*http.Response, error) {
+ reqHeaders := make(http.Header)
+ 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, "v2beta1/{+parent}/agent")
+ 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{
+ "parent": c.parent,
+ })
+ return gensupport.SendRequest(c.ctx_, c.s.client, req)
+}
+
+// Do executes the "dialogflow.projects.deleteAgent" call.
+// Exactly one of *GoogleProtobufEmpty or error will be non-nil. Any
+// non-2xx status code is an error. Response headers are in either
+// *GoogleProtobufEmpty.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 *ProjectsDeleteAgentCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, 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 := &GoogleProtobufEmpty{
+ 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 specified agent.",
+ // "flatPath": "v2beta1/projects/{projectsId}/agent",
+ // "httpMethod": "DELETE",
+ // "id": "dialogflow.projects.deleteAgent",
+ // "parameterOrder": [
+ // "parent"
+ // ],
+ // "parameters": {
+ // "parent": {
+ // "description": "Required. The project that the agent to delete is associated with.\nFormat: `projects/\u003cProject ID\u003e`.",
+ // "location": "path",
+ // "pattern": "^projects/[^/]+$",
+ // "required": true,
+ // "type": "string"
+ // }
+ // },
+ // "path": "v2beta1/{+parent}/agent",
+ // "response": {
+ // "$ref": "GoogleProtobufEmpty"
+ // },
+ // "scopes": [
+ // "https://www.googleapis.com/auth/cloud-platform",
+ // "https://www.googleapis.com/auth/dialogflow"
+ // ]
+ // }
+
+}
+
// method id "dialogflow.projects.getAgent":
type ProjectsGetAgentCall struct {
diff --git a/dns/v1beta2/dns-api.json b/dns/v1beta2/dns-api.json
index d563104..09843ef 100644
--- a/dns/v1beta2/dns-api.json
+++ b/dns/v1beta2/dns-api.json
@@ -18,12 +18,12 @@
}
},
"basePath": "/dns/v1beta2/projects/",
- "baseUrl": "https://www.googleapis.com/dns/v1beta2/projects/",
+ "baseUrl": "https://dns.googleapis.com/dns/v1beta2/projects/",
"batchPath": "batch/dns/v1beta2",
"description": "Configures and serves authoritative DNS records.",
"discoveryVersion": "v1",
"documentationLink": "https://developers.google.com/cloud-dns",
- "etag": "\"VPK3KBfpaEgZ16pozGOoMYfKc0U/5ETkYc51ldAG_lBus_hxlXlq9uQ\"",
+ "etag": "\"9eZ1uxVRThTDhLJCZHhqs3eQWz4/tZodWpNji3ot_YmPPgfJSu7AV8c\"",
"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"
@@ -982,8 +982,8 @@
}
}
},
- "revision": "20190418",
- "rootUrl": "https://www.googleapis.com/",
+ "revision": "20190611",
+ "rootUrl": "https://dns.googleapis.com/",
"schemas": {
"Change": {
"description": "A Change represents a set of ResourceRecordSet additions and deletions applied atomically to a ManagedZone. ResourceRecordSets within a ManagedZone are modified by creating a new Change element in the Changes collection. In turn the Changes collection also records the past modifications to the ResourceRecordSets in a ManagedZone. The current state of the ManagedZone is the sum effect of applying all Change elements in the Changes collection in sequence.",
diff --git a/dns/v1beta2/dns-gen.go b/dns/v1beta2/dns-gen.go
index 7ff0c44..aafe632 100644
--- a/dns/v1beta2/dns-gen.go
+++ b/dns/v1beta2/dns-gen.go
@@ -76,7 +76,7 @@
const apiId = "dns:v1beta2"
const apiName = "dns"
const apiVersion = "v1beta2"
-const basePath = "https://www.googleapis.com/dns/v1beta2/projects/"
+const basePath = "https://dns.googleapis.com/dns/v1beta2/projects/"
// OAuth2 scopes used by this API.
const (
diff --git a/iam/v1/iam-api.json b/iam/v1/iam-api.json
index ce6a5d2..b248f78 100644
--- a/iam/v1/iam-api.json
+++ b/iam/v1/iam-api.json
@@ -1193,7 +1193,7 @@
}
}
},
- "revision": "20190530",
+ "revision": "20190607",
"rootUrl": "https://iam.googleapis.com/",
"schemas": {
"AdminAuditData": {
@@ -1964,6 +1964,20 @@
],
"type": "string"
},
+ "keyOrigin": {
+ "description": "The key origin.",
+ "enum": [
+ "ORIGIN_UNSPECIFIED",
+ "USER_PROVIDED",
+ "GOOGLE_PROVIDED"
+ ],
+ "enumDescriptions": [
+ "Unspecified key origin.",
+ "Key is provided by user.",
+ "Key is provided by Google."
+ ],
+ "type": "string"
+ },
"name": {
"description": "The resource name of the service account key in the following format\n`projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}`.",
"type": "string"
diff --git a/iam/v1/iam-gen.go b/iam/v1/iam-gen.go
index 6ec7355..2ca8b9b 100644
--- a/iam/v1/iam-gen.go
+++ b/iam/v1/iam-gen.go
@@ -1900,6 +1900,14 @@
// "KEY_ALG_RSA_2048" - 2k RSA Key.
KeyAlgorithm string `json:"keyAlgorithm,omitempty"`
+ // KeyOrigin: The key origin.
+ //
+ // Possible values:
+ // "ORIGIN_UNSPECIFIED" - Unspecified key origin.
+ // "USER_PROVIDED" - Key is provided by user.
+ // "GOOGLE_PROVIDED" - Key is provided by Google.
+ KeyOrigin string `json:"keyOrigin,omitempty"`
+
// Name: The resource name of the service account key in the following
// format
// `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}`.
diff --git a/logging/v2/logging-api.json b/logging/v2/logging-api.json
index a854c0b..bdb7364 100644
--- a/logging/v2/logging-api.json
+++ b/logging/v2/logging-api.json
@@ -2535,7 +2535,7 @@
}
}
},
- "revision": "20190531",
+ "revision": "20190608",
"rootUrl": "https://logging.googleapis.com/",
"schemas": {
"BucketOptions": {
@@ -2923,7 +2923,7 @@
},
"resource": {
"$ref": "MonitoredResource",
- "description": "Required. The primary monitored resource associated with this log entry.Example: a log entry that reports a database error would be associated with the monitored resource designating the particular database that reported the error."
+ "description": "Required. The monitored resource that produced this log entry.Example: a log entry that reports a database error would be associated with the monitored resource designating the particular database that reported the error."
},
"severity": {
"description": "Optional. The severity of the log entry. The default value is LogSeverity.DEFAULT.",
diff --git a/logging/v2/logging-gen.go b/logging/v2/logging-gen.go
index f4874eb..118efde 100644
--- a/logging/v2/logging-gen.go
+++ b/logging/v2/logging-gen.go
@@ -1137,10 +1137,10 @@
// Logging.
ReceiveTimestamp string `json:"receiveTimestamp,omitempty"`
- // Resource: Required. The primary monitored resource associated with
- // this log entry.Example: a log entry that reports a database error
- // would be associated with the monitored resource designating the
- // particular database that reported the error.
+ // Resource: Required. The monitored resource that produced this log
+ // entry.Example: a log entry that reports a database error would be
+ // associated with the monitored resource designating the particular
+ // database that reported the error.
Resource *MonitoredResource `json:"resource,omitempty"`
// Severity: Optional. The severity of the log entry. The default value
diff --git a/monitoring/v3/monitoring-api.json b/monitoring/v3/monitoring-api.json
index 1e89776..16e13ef 100644
--- a/monitoring/v3/monitoring-api.json
+++ b/monitoring/v3/monitoring-api.json
@@ -1457,7 +1457,7 @@
}
}
},
- "revision": "20190604",
+ "revision": "20190611",
"rootUrl": "https://monitoring.googleapis.com/",
"schemas": {
"Aggregation": {
@@ -2758,7 +2758,7 @@
"type": "object"
},
"MonitoredResourceDescriptor": {
- "description": "An object that describes the schema of a MonitoredResource object using a type name and a set of labels. For example, the monitored resource descriptor for Google Compute Engine VM instances has a type of \"gce_instance\" and specifies the use of the labels \"instance_id\" and \"zone\" to identify particular VM instances.Different APIs can support different monitored resource types. APIs generally provide a list method that returns the monitored resource descriptors used by the API.Next ID: 10",
+ "description": "An object that describes the schema of a MonitoredResource object using a type name and a set of labels. For example, the monitored resource descriptor for Google Compute Engine VM instances has a type of \"gce_instance\" and specifies the use of the labels \"instance_id\" and \"zone\" to identify particular VM instances.Different APIs can support different monitored resource types. APIs generally provide a list method that returns the monitored resource descriptors used by the API.",
"id": "MonitoredResourceDescriptor",
"properties": {
"description": {
diff --git a/monitoring/v3/monitoring-gen.go b/monitoring/v3/monitoring-gen.go
index 181c26f..23d9da0 100644
--- a/monitoring/v3/monitoring-gen.go
+++ b/monitoring/v3/monitoring-gen.go
@@ -2845,7 +2845,7 @@
// the labels "instance_id" and "zone" to identify particular VM
// instances.Different APIs can support different monitored resource
// types. APIs generally provide a list method that returns the
-// monitored resource descriptors used by the API.Next ID: 10
+// monitored resource descriptors used by the API.
type MonitoredResourceDescriptor struct {
// Description: Optional. A detailed description of the monitored
// resource type that might be used in documentation.
diff --git a/pubsub/v1/pubsub-api.json b/pubsub/v1/pubsub-api.json
index bcd0deb..6186066 100644
--- a/pubsub/v1/pubsub-api.json
+++ b/pubsub/v1/pubsub-api.json
@@ -1074,7 +1074,7 @@
}
}
},
- "revision": "20190429",
+ "revision": "20190606",
"rootUrl": "https://pubsub.googleapis.com/",
"schemas": {
"AcknowledgeRequest": {
@@ -1262,6 +1262,19 @@
},
"type": "object"
},
+ "MessageStoragePolicy": {
+ "id": "MessageStoragePolicy",
+ "properties": {
+ "allowedPersistenceRegions": {
+ "description": "The list of GCP region IDs where messages that are published to the topic\nmay be persisted in storage. Messages published by publishers running in\nnon-allowed GCP regions (or running outside of GCP altogether) will be\nrouted for storage in one of the allowed regions. An empty list indicates a\nmisconfiguration at the project or organization level, which will result in\nall Publish operations failing.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
"ModifyAckDeadlineRequest": {
"description": "Request for the ModifyAckDeadline method.",
"id": "ModifyAckDeadlineRequest",
@@ -1590,6 +1603,10 @@
"description": "A topic resource.",
"id": "Topic",
"properties": {
+ "kmsKeyName": {
+ "description": "The resource name of the Cloud KMS CryptoKey to be used to protect access\nto messages published on this topic.\n\nThe expected format is `projects/*/locations/*/keyRings/*/cryptoKeys/*`.",
+ "type": "string"
+ },
"labels": {
"additionalProperties": {
"type": "string"
@@ -1597,6 +1614,10 @@
"description": "See \u003ca href=\"https://cloud.google.com/pubsub/docs/labels\"\u003e Creating and\nmanaging labels\u003c/a\u003e.",
"type": "object"
},
+ "messageStoragePolicy": {
+ "$ref": "MessageStoragePolicy",
+ "description": "Policy constraining how messages published to the topic may be stored. It\nis determined when the topic is created based on the policy configured at\nthe project level. It must not be set by the caller in the request to\nCreateTopic or to UpdateTopic. This field will be populated in the\nresponses for GetTopic, CreateTopic, and UpdateTopic: if not present in the\nresponse, then no constraints are in effect."
+ },
"name": {
"description": "The name of the topic. It must have the format\n`\"projects/{project}/topics/{topic}\"`. `{topic}` must start with a letter,\nand contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),\nunderscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent\nsigns (`%`). It must be between 3 and 255 characters in length, and it\nmust not start with `\"goog\"`.",
"type": "string"
diff --git a/pubsub/v1/pubsub-gen.go b/pubsub/v1/pubsub-gen.go
index 10ae6c9..5305f77 100644
--- a/pubsub/v1/pubsub-gen.go
+++ b/pubsub/v1/pubsub-gen.go
@@ -661,6 +661,45 @@
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
+type MessageStoragePolicy struct {
+ // AllowedPersistenceRegions: The list of GCP region IDs where messages
+ // that are published to the topic
+ // may be persisted in storage. Messages published by publishers running
+ // in
+ // non-allowed GCP regions (or running outside of GCP altogether) will
+ // be
+ // routed for storage in one of the allowed regions. An empty list
+ // indicates a
+ // misconfiguration at the project or organization level, which will
+ // result in
+ // all Publish operations failing.
+ AllowedPersistenceRegions []string `json:"allowedPersistenceRegions,omitempty"`
+
+ // ForceSendFields is a list of field names (e.g.
+ // "AllowedPersistenceRegions") to unconditionally include in API
+ // requests. By default, fields with empty 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.
+ // "AllowedPersistenceRegions") 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 *MessageStoragePolicy) MarshalJSON() ([]byte, error) {
+ type NoMethod MessageStoragePolicy
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// ModifyAckDeadlineRequest: Request for the ModifyAckDeadline method.
type ModifyAckDeadlineRequest struct {
// AckDeadlineSeconds: The new ack deadline with respect to the time
@@ -1570,11 +1609,32 @@
// Topic: A topic resource.
type Topic struct {
+ // KmsKeyName: The resource name of the Cloud KMS CryptoKey to be used
+ // to protect access
+ // to messages published on this topic.
+ //
+ // The expected format is
+ // `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
+ KmsKeyName string `json:"kmsKeyName,omitempty"`
+
// Labels: See <a href="https://cloud.google.com/pubsub/docs/labels">
// Creating and
// managing labels</a>.
Labels map[string]string `json:"labels,omitempty"`
+ // MessageStoragePolicy: Policy constraining how messages published to
+ // the topic may be stored. It
+ // is determined when the topic is created based on the policy
+ // configured at
+ // the project level. It must not be set by the caller in the request
+ // to
+ // CreateTopic or to UpdateTopic. This field will be populated in
+ // the
+ // responses for GetTopic, CreateTopic, and UpdateTopic: if not present
+ // in the
+ // response, then no constraints are in effect.
+ MessageStoragePolicy *MessageStoragePolicy `json:"messageStoragePolicy,omitempty"`
+
// Name: The name of the topic. It must have the
// format
// "projects/{project}/topics/{topic}". `{topic}` must start with a
@@ -1592,7 +1652,7 @@
// server.
googleapi.ServerResponse `json:"-"`
- // ForceSendFields is a list of field names (e.g. "Labels") to
+ // ForceSendFields is a list of field names (e.g. "KmsKeyName") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
@@ -1600,8 +1660,8 @@
// 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
+ // NullFields is a list of field names (e.g. "KmsKeyName") 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.
diff --git a/remotebuildexecution/v1/remotebuildexecution-api.json b/remotebuildexecution/v1/remotebuildexecution-api.json
index 7f50f92..dd0fd67 100644
--- a/remotebuildexecution/v1/remotebuildexecution-api.json
+++ b/remotebuildexecution/v1/remotebuildexecution-api.json
@@ -337,7 +337,7 @@
}
}
},
- "revision": "20190604",
+ "revision": "20190612",
"rootUrl": "https://remotebuildexecution.googleapis.com/",
"schemas": {
"BuildBazelRemoteExecutionV2Action": {
@@ -349,7 +349,7 @@
"description": "The digest of the Command\nto run, which MUST be present in the\nContentAddressableStorage."
},
"doNotCache": {
- "description": "If true, then the `Action`'s result cannot be cached.",
+ "description": "If true, then the `Action`'s result cannot be cached, and in-flight\nrequests for the same `Action` may not be merged.",
"type": "boolean"
},
"inputRootDigest": {
@@ -378,28 +378,28 @@
"type": "integer"
},
"outputDirectories": {
- "description": "The output directories of the action. For each output directory requested\nin the `output_directories` field of the Action, if the corresponding\ndirectory existed after the action completed, a single entry will be\npresent in the output list, which will contain the digest of a\nTree message containing the\ndirectory tree, and the path equal exactly to the corresponding Action\noutput_directories member.\n\nAs an example, suppose the Action had an output directory `a/b/dir` and the\nexecution produced the following contents in `a/b/dir`: a file named `bar`\nand a directory named `foo` with an executable file named `baz`. Then,\noutput_directory will contain (hashes shortened for readability):\n\n```json\n// OutputDirectory proto:\n{\n path: \"a/b/dir\"\n tree_digest: {\n hash: \"4a73bc9d03...\",\n size: 55\n }\n}\n// Tree proto with hash \"4a73bc9d03...\" and size 55:\n{\n root: {\n files: [\n {\n name: \"bar\",\n digest: {\n hash: \"4a73bc9d03...\",\n size: 65534\n }\n }\n ],\n directories: [\n {\n name: \"foo\",\n digest: {\n hash: \"4cf2eda940...\",\n size: 43\n }\n }\n ]\n }\n children : {\n // (Directory proto with hash \"4cf2eda940...\" and size 43)\n files: [\n {\n name: \"baz\",\n digest: {\n hash: \"b2c941073e...\",\n size: 1294,\n },\n is_executable: true\n }\n ]\n }\n}\n```",
+ "description": "The output directories of the action. For each output directory requested\nin the `output_directories` field of the Action, if the corresponding\ndirectory existed after the action completed, a single entry will be\npresent in the output list, which will contain the digest of a\nTree message containing the\ndirectory tree, and the path equal exactly to the corresponding Action\noutput_directories member.\n\nAs an example, suppose the Action had an output directory `a/b/dir` and the\nexecution produced the following contents in `a/b/dir`: a file named `bar`\nand a directory named `foo` with an executable file named `baz`. Then,\noutput_directory will contain (hashes shortened for readability):\n\n```json\n// OutputDirectory proto:\n{\n path: \"a/b/dir\"\n tree_digest: {\n hash: \"4a73bc9d03...\",\n size: 55\n }\n}\n// Tree proto with hash \"4a73bc9d03...\" and size 55:\n{\n root: {\n files: [\n {\n name: \"bar\",\n digest: {\n hash: \"4a73bc9d03...\",\n size: 65534\n }\n }\n ],\n directories: [\n {\n name: \"foo\",\n digest: {\n hash: \"4cf2eda940...\",\n size: 43\n }\n }\n ]\n }\n children : {\n // (Directory proto with hash \"4cf2eda940...\" and size 43)\n files: [\n {\n name: \"baz\",\n digest: {\n hash: \"b2c941073e...\",\n size: 1294,\n },\n is_executable: true\n }\n ]\n }\n}\n```\nIf an output of the same name was found, but was not a directory, the\nserver will return a FAILED_PRECONDITION.",
"items": {
"$ref": "BuildBazelRemoteExecutionV2OutputDirectory"
},
"type": "array"
},
"outputDirectorySymlinks": {
- "description": "The output directories of the action that are symbolic links to other\ndirectories. Those may be links to other output directories, or input\ndirectories, or even absolute paths outside of the working directory,\nif the server supports\nSymlinkAbsolutePathStrategy.ALLOWED.\nFor each output directory requested in the `output_directories` field of\nthe Action, if the directory file existed after\nthe action completed, a single entry will be present either in this field,\nor in the `output_directories` field, if the directory was not a symbolic link.\n\nIf the action does not produce the requested output, or produces a\nfile where a directory is expected or vice versa, then that output\nwill be omitted from the list. The server is free to arrange the output\nlist as desired; clients MUST NOT assume that the output list is sorted.",
+ "description": "The output directories of the action that are symbolic links to other\ndirectories. Those may be links to other output directories, or input\ndirectories, or even absolute paths outside of the working directory,\nif the server supports\nSymlinkAbsolutePathStrategy.ALLOWED.\nFor each output directory requested in the `output_directories` field of\nthe Action, if the directory existed after the action completed, a\nsingle entry will be present either in this field, or in the\n`output_directories` field, if the directory was not a symbolic link.\n\nIf an output of the same name was found, but was a symbolic link to a file\ninstead of a directory, the server will return a FAILED_PRECONDITION.\nIf the action does not produce the requested output, then that output\nwill be omitted from the list. The server is free to arrange the output\nlist as desired; clients MUST NOT assume that the output list is sorted.",
"items": {
"$ref": "BuildBazelRemoteExecutionV2OutputSymlink"
},
"type": "array"
},
"outputFileSymlinks": {
- "description": "The output files of the action that are symbolic links to other files. Those\nmay be links to other output files, or input files, or even absolute paths\noutside of the working directory, if the server supports\nSymlinkAbsolutePathStrategy.ALLOWED.\nFor each output file requested in the `output_files` field of the Action,\nif the corresponding file existed after\nthe action completed, a single entry will be present either in this field,\nor in the `output_files` field, if the file was not a symbolic link.\n\nIf the action does not produce the requested output, or produces a\ndirectory where a regular file is expected or vice versa, then that output\nwill be omitted from the list. The server is free to arrange the output\nlist as desired; clients MUST NOT assume that the output list is sorted.",
+ "description": "The output files of the action that are symbolic links to other files. Those\nmay be links to other output files, or input files, or even absolute paths\noutside of the working directory, if the server supports\nSymlinkAbsolutePathStrategy.ALLOWED.\nFor each output file requested in the `output_files` field of the Action,\nif the corresponding file existed after\nthe action completed, a single entry will be present either in this field,\nor in the `output_files` field, if the file was not a symbolic link.\n\nIf an output symbolic link of the same name was found, but its target\ntype was not a regular file, the server will return a FAILED_PRECONDITION.\nIf the action does not produce the requested output, then that output\nwill be omitted from the list. The server is free to arrange the output\nlist as desired; clients MUST NOT assume that the output list is sorted.",
"items": {
"$ref": "BuildBazelRemoteExecutionV2OutputSymlink"
},
"type": "array"
},
"outputFiles": {
- "description": "The output files of the action. For each output file requested in the\n`output_files` field of the Action, if the corresponding file existed after\nthe action completed, a single entry will be present either in this field,\nor in the output_file_symlinks field, if the file was a symbolic link to\nanother file.\n\nIf the action does not produce the requested output, or produces a\ndirectory where a regular file is expected or vice versa, then that output\nwill be omitted from the list. The server is free to arrange the output\nlist as desired; clients MUST NOT assume that the output list is sorted.",
+ "description": "The output files of the action. For each output file requested in the\n`output_files` field of the Action, if the corresponding file existed after\nthe action completed, a single entry will be present either in this field,\nor the `output_file_symlinks` field if the file was a symbolic link to\nanother file.\n\nIf an output of the same name was found, but was a directory rather\nthan a regular file, the server will return a FAILED_PRECONDITION.\nIf the action does not produce the requested output, then that output\nwill be omitted from the list. The server is free to arrange the output\nlist as desired; clients MUST NOT assume that the output list is sorted.",
"items": {
"$ref": "BuildBazelRemoteExecutionV2OutputFile"
},
@@ -407,19 +407,19 @@
},
"stderrDigest": {
"$ref": "BuildBazelRemoteExecutionV2Digest",
- "description": "The digest for a blob containing the standard error of the action, which\ncan be retrieved from the\nContentAddressableStorage.\nSee `stderr_raw` for when this will be set."
+ "description": "The digest for a blob containing the standard error of the action, which\ncan be retrieved from the\nContentAddressableStorage."
},
"stderrRaw": {
- "description": "The standard error buffer of the action. The server will determine, based\non the size of the buffer, whether to return it in raw form or to return\na digest in `stderr_digest` that points to the buffer. If neither is set,\nthen the buffer is empty. The client SHOULD NOT assume it will get one of\nthe raw buffer or a digest on any given request and should be prepared to\nhandle either.",
+ "description": "The standard error buffer of the action. The server SHOULD NOT inline\nstderr unless requested by the client in the\nGetActionResultRequest\nmessage. The server MAY omit inlining, even if requested, and MUST do so if inlining\nwould cause the response to exceed message size limits.",
"format": "byte",
"type": "string"
},
"stdoutDigest": {
"$ref": "BuildBazelRemoteExecutionV2Digest",
- "description": "The digest for a blob containing the standard output of the action, which\ncan be retrieved from the\nContentAddressableStorage.\nSee `stdout_raw` for when this will be set."
+ "description": "The digest for a blob containing the standard output of the action, which\ncan be retrieved from the\nContentAddressableStorage."
},
"stdoutRaw": {
- "description": "The standard output buffer of the action. The server will determine, based\non the size of the buffer, whether to return it in raw form or to return\na digest in `stdout_digest` that points to the buffer. If neither is set,\nthen the buffer is empty. The client SHOULD NOT assume it will get one of\nthe raw buffer or a digest on any given request and should be prepared to\nhandle either.",
+ "description": "The standard output buffer of the action. The server SHOULD NOT inline\nstdout unless requested by the client in the\nGetActionResultRequest\nmessage. The server MAY omit inlining, even if requested, and MUST do so if inlining\nwould cause the response to exceed message size limits.",
"format": "byte",
"type": "string"
}
@@ -445,7 +445,7 @@
"type": "array"
},
"outputDirectories": {
- "description": "A list of the output directories that the client expects to retrieve from\nthe action. Only the listed directories will be returned (an entire\ndirectory structure will be returned as a\nTree message digest, see\nOutputDirectory), as\nwell as files listed in `output_files`. Other files or directories that\nmay be created during command execution are discarded.\n\nThe paths are relative to the working directory of the action execution.\nThe paths are specified using a single forward slash (`/`) as a path\nseparator, even if the execution platform natively uses a different\nseparator. The path MUST NOT include a trailing slash, nor a leading slash,\nbeing a relative path. The special value of empty string is allowed,\nalthough not recommended, and can be used to capture the entire working\ndirectory tree, including inputs.\n\nIn order to ensure consistent hashing of the same Action, the output paths\nMUST be sorted lexicographically by code point (or, equivalently, by UTF-8\nbytes).\n\nAn output directory cannot be duplicated or have the same path as any of\nthe listed output files.\n\nDirectories leading up to the output directories (but not the output\ndirectories themselves) are created by the worker prior to execution, even\nif they are not explicitly part of the input root.",
+ "description": "A list of the output directories that the client expects to retrieve from\nthe action. Only the listed directories will be returned (an entire\ndirectory structure will be returned as a\nTree message digest, see\nOutputDirectory), as\nwell as files listed in `output_files`. Other files or directories that\nmay be created during command execution are discarded.\n\nThe paths are relative to the working directory of the action execution.\nThe paths are specified using a single forward slash (`/`) as a path\nseparator, even if the execution platform natively uses a different\nseparator. The path MUST NOT include a trailing slash, nor a leading slash,\nbeing a relative path. The special value of empty string is allowed,\nalthough not recommended, and can be used to capture the entire working\ndirectory tree, including inputs.\n\nIn order to ensure consistent hashing of the same Action, the output paths\nMUST be sorted lexicographically by code point (or, equivalently, by UTF-8\nbytes).\n\nAn output directory cannot be duplicated or have the same path as any of\nthe listed output files. An output directory is allowed to be a parent of\nanother output directory.\n\nDirectories leading up to the output directories (but not the output\ndirectories themselves) are created by the worker prior to execution, even\nif they are not explicitly part of the input root.",
"items": {
"type": "string"
},
@@ -460,7 +460,7 @@
},
"platform": {
"$ref": "BuildBazelRemoteExecutionV2Platform",
- "description": "The platform requirements for the execution environment. The server MAY\nchoose to execute the action on any worker satisfying the requirements, so\nthe client SHOULD ensure that running the action on any such worker will\nhave the same result."
+ "description": "The platform requirements for the execution environment. The server MAY\nchoose to execute the action on any worker satisfying the requirements, so\nthe client SHOULD ensure that running the action on any such worker will\nhave the same result.\nA detailed lexicon for this can be found in the accompanying platform.md."
},
"workingDirectory": {
"description": "The working directory, relative to the input root, for the command to run\nin. It must be a directory which exists in the input tree. If it is left\nempty, then the action is run in the input root.",
@@ -501,7 +501,7 @@
"type": "object"
},
"BuildBazelRemoteExecutionV2Directory": {
- "description": "A `Directory` represents a directory node in a file tree, containing zero or\nmore children FileNodes,\nDirectoryNodes and\nSymlinkNodes.\nEach `Node` contains its name in the directory, either the digest of its\ncontent (either a file blob or a `Directory` proto) or a symlink target, as\nwell as possibly some metadata about the file or directory.\n\nIn order to ensure that two equivalent directory trees hash to the same\nvalue, the following restrictions MUST be obeyed when constructing a\na `Directory`:\n\n* Every child in the directory must have a path of exactly one segment.\n Multiple levels of directory hierarchy may not be collapsed.\n* Each child in the directory must have a unique path segment (file name).\n* The files, directories and symlinks in the directory must each be sorted\n in lexicographical order by path. The path strings must be sorted by code\n point, equivalently, by UTF-8 bytes.\n\nA `Directory` that obeys the restrictions is said to be in canonical form.\n\nAs an example, the following could be used for a file named `bar` and a\ndirectory named `foo` with an executable file named `baz` (hashes shortened\nfor readability):\n\n```json\n// (Directory proto)\n{\n files: [\n {\n name: \"bar\",\n digest: {\n hash: \"4a73bc9d03...\",\n size: 65534\n }\n }\n ],\n directories: [\n {\n name: \"foo\",\n digest: {\n hash: \"4cf2eda940...\",\n size: 43\n }\n }\n ]\n}\n\n// (Directory proto with hash \"4cf2eda940...\" and size 43)\n{\n files: [\n {\n name: \"baz\",\n digest: {\n hash: \"b2c941073e...\",\n size: 1294,\n },\n is_executable: true\n }\n ]\n}\n```",
+ "description": "A `Directory` represents a directory node in a file tree, containing zero or\nmore children FileNodes,\nDirectoryNodes and\nSymlinkNodes.\nEach `Node` contains its name in the directory, either the digest of its\ncontent (either a file blob or a `Directory` proto) or a symlink target, as\nwell as possibly some metadata about the file or directory.\n\nIn order to ensure that two equivalent directory trees hash to the same\nvalue, the following restrictions MUST be obeyed when constructing a\na `Directory`:\n\n* Every child in the directory must have a path of exactly one segment.\n Multiple levels of directory hierarchy may not be collapsed.\n* Each child in the directory must have a unique path segment (file name).\n Note that while the API itself is case-sensitive, the environment where\n the Action is executed may or may not be case-sensitive. That is, it is\n legal to call the API with a Directory that has both \"Foo\" and \"foo\" as\n children, but the Action may be rejected by the remote system upon\n execution.\n* The files, directories and symlinks in the directory must each be sorted\n in lexicographical order by path. The path strings must be sorted by code\n point, equivalently, by UTF-8 bytes.\n\nA `Directory` that obeys the restrictions is said to be in canonical form.\n\nAs an example, the following could be used for a file named `bar` and a\ndirectory named `foo` with an executable file named `baz` (hashes shortened\nfor readability):\n\n```json\n// (Directory proto)\n{\n files: [\n {\n name: \"bar\",\n digest: {\n hash: \"4a73bc9d03...\",\n size: 65534\n }\n }\n ],\n directories: [\n {\n name: \"foo\",\n digest: {\n hash: \"4cf2eda940...\",\n size: 43\n }\n }\n ]\n}\n\n// (Directory proto with hash \"4cf2eda940...\" and size 43)\n{\n files: [\n {\n name: \"baz\",\n digest: {\n hash: \"b2c941073e...\",\n size: 1294,\n },\n is_executable: true\n }\n ]\n}\n```",
"id": "BuildBazelRemoteExecutionV2Directory",
"properties": {
"directories": {
@@ -552,6 +552,7 @@
"description": "The digest of the Action\nbeing executed."
},
"stage": {
+ "description": "The current stage of execution.",
"enum": [
"UNKNOWN",
"CACHE_CHECK",
@@ -560,7 +561,7 @@
"COMPLETED"
],
"enumDescriptions": [
- "",
+ "Invalid value.",
"Checking the result against the cache.",
"Currently idle, awaiting a free machine to execute.",
"Currently being executed by a worker.",
@@ -715,9 +716,14 @@
"type": "object"
},
"BuildBazelRemoteExecutionV2OutputFile": {
- "description": "An `OutputFile` is similar to a\nFileNode, but it is used as an\noutput in an `ActionResult`. It allows a full file path rather than\nonly a name.\n\n`OutputFile` is binary-compatible with `FileNode`.",
+ "description": "An `OutputFile` is similar to a\nFileNode, but it is used as an\noutput in an `ActionResult`. It allows a full file path rather than\nonly a name.",
"id": "BuildBazelRemoteExecutionV2OutputFile",
"properties": {
+ "contents": {
+ "description": "The contents of the file if inlining was requested. The server SHOULD NOT inline\nfile contents unless requested by the client in the\nGetActionResultRequest\nmessage. The server MAY omit inlining, even if requested, and MUST do so if inlining\nwould cause the response to exceed message size limits.",
+ "format": "byte",
+ "type": "string"
+ },
"digest": {
"$ref": "BuildBazelRemoteExecutionV2Digest",
"description": "The digest of the file's content."
@@ -778,7 +784,7 @@
"type": "object"
},
"BuildBazelRemoteExecutionV2RequestMetadata": {
- "description": "An optional Metadata to attach to any RPC request to tell the server about an\nexternal context of the request. The server may use this for logging or other\npurposes. To use it, the client attaches the header to the call using the\ncanonical proto serialization:\n\n* name: `build.bazel.remote.execution.v2.requestmetadata-bin`\n* contents: the base64 encoded binary `RequestMetadata` message.",
+ "description": "An optional Metadata to attach to any RPC request to tell the server about an\nexternal context of the request. The server may use this for logging or other\npurposes. To use it, the client attaches the header to the call using the\ncanonical proto serialization:\n\n* name: `build.bazel.remote.execution.v2.requestmetadata-bin`\n* contents: the base64 encoded binary `RequestMetadata` message.\nNote: the gRPC library serializes binary headers encoded in base 64 by\ndefault (https://github.com/grpc/grpc/blob/master/doc/PROTOCOL-HTTP2.md#requests).\nTherefore, if the gRPC library is used to pass/retrieve this\nmetadata, the user may ignore the base64 encoding and assume it is simply\nserialized as a binary message.",
"id": "BuildBazelRemoteExecutionV2RequestMetadata",
"properties": {
"actionId": {
@@ -1129,6 +1135,10 @@
"GoogleDevtoolsRemotebuildexecutionAdminV1alphaListWorkerPoolsRequest": {
"id": "GoogleDevtoolsRemotebuildexecutionAdminV1alphaListWorkerPoolsRequest",
"properties": {
+ "filter": {
+ "description": "Optional. A filter to constrain the pools returned. Filters have the form:\n\n\u003cfield\u003e \u003coperator\u003e \u003cvalue\u003e [[AND|OR] \u003cfield\u003e \u003coperator\u003e \u003cvalue\u003e]...\n\n\u003cfield\u003e is the path for a field or map key in the Pool proto message.\ne.g. \"configuration.disk_size_gb\" or \"configuration.labels.key\".\n\u003coperator\u003e can be one of \"\u003c\", \"\u003c=\", \"\u003e=\", \"\u003e\", \"=\", \"!=\", \":\".\n\":\" is a HAS operation for strings and repeated primitive fields.\n\u003cvalue\u003e is the value to test, case-insensitive for strings. \"*\" stands for\nany value and can be used to test for key presence.\nParenthesis determine AND/OR precedence. In space separated restrictions,\nAND is implicit, e.g. \"a = b x = y\" is equivalent to \"a = b AND x = y\".\n\nExample filter:\nconfiguration.labels.key1 = * AND (state = RUNNING OR state = UPDATING)\n\nThis field is currently ignored in all requests.",
+ "type": "string"
+ },
"parent": {
"description": "Resource name of the instance.\nFormat: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.",
"type": "string"
@@ -1178,6 +1188,13 @@
"description": "Required. Disk Type to use for the worker.\nSee [Storage\noptions](https://cloud.google.com/compute/docs/disks/#introduction).\nCurrently only `pd-standard` is supported.",
"type": "string"
},
+ "labels": {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "description": "Labels associated with the workers.\nLabel keys and values can be no longer than 63 characters, can only contain\nlowercase letters, numeric characters, underscores and dashes.\nInternational letters are permitted. Keys must start with a letter but\nvalues are optional.\nThis field is currently ignored in all requests.",
+ "type": "object"
+ },
"machineType": {
"description": "Required. Machine type of the worker, such as `n1-standard-2`.\nSee https://cloud.google.com/compute/docs/machine-types for a list of\nsupported machine types. Note that `f1-micro` and `g1-small` are not yet\nsupported.",
"type": "string"
diff --git a/remotebuildexecution/v1/remotebuildexecution-gen.go b/remotebuildexecution/v1/remotebuildexecution-gen.go
index 638ffcb..693071e 100644
--- a/remotebuildexecution/v1/remotebuildexecution-gen.go
+++ b/remotebuildexecution/v1/remotebuildexecution-gen.go
@@ -224,7 +224,9 @@
// ContentAddressableStorage.
CommandDigest *BuildBazelRemoteExecutionV2Digest `json:"commandDigest,omitempty"`
- // DoNotCache: If true, then the `Action`'s result cannot be cached.
+ // DoNotCache: If true, then the `Action`'s result cannot be cached, and
+ // in-flight
+ // requests for the same `Action` may not be merged.
DoNotCache bool `json:"doNotCache,omitempty"`
// InputRootDigest: The digest of the root
@@ -369,6 +371,9 @@
// }
// }
// ```
+ // If an output of the same name was found, but was not a directory,
+ // the
+ // server will return a FAILED_PRECONDITION.
OutputDirectories []*BuildBazelRemoteExecutionV2OutputDirectory `json:"outputDirectories,omitempty"`
// OutputDirectorySymlinks: The output directories of the action that
@@ -381,15 +386,18 @@
// SymlinkAbsolutePathStrategy.ALLOWED.
// For each output directory requested in the `output_directories` field
// of
- // the Action, if the directory file existed after
- // the action completed, a single entry will be present either in this
- // field,
- // or in the `output_directories` field, if the directory was not a
- // symbolic link.
- //
- // If the action does not produce the requested output, or produces
+ // the Action, if the directory existed after the action completed,
// a
- // file where a directory is expected or vice versa, then that
+ // single entry will be present either in this field, or in
+ // the
+ // `output_directories` field, if the directory was not a symbolic
+ // link.
+ //
+ // If an output of the same name was found, but was a symbolic link to a
+ // file
+ // instead of a directory, the server will return a
+ // FAILED_PRECONDITION.
+ // If the action does not produce the requested output, then that
// output
// will be omitted from the list. The server is free to arrange the
// output
@@ -412,9 +420,11 @@
// or in the `output_files` field, if the file was not a symbolic
// link.
//
- // If the action does not produce the requested output, or produces
- // a
- // directory where a regular file is expected or vice versa, then that
+ // If an output symbolic link of the same name was found, but its
+ // target
+ // type was not a regular file, the server will return a
+ // FAILED_PRECONDITION.
+ // If the action does not produce the requested output, then that
// output
// will be omitted from the list. The server is free to arrange the
// output
@@ -428,13 +438,14 @@
// after
// the action completed, a single entry will be present either in this
// field,
- // or in the output_file_symlinks field, if the file was a symbolic link
+ // or the `output_file_symlinks` field if the file was a symbolic link
// to
// another file.
//
- // If the action does not produce the requested output, or produces
- // a
- // directory where a regular file is expected or vice versa, then that
+ // If an output of the same name was found, but was a directory
+ // rather
+ // than a regular file, the server will return a FAILED_PRECONDITION.
+ // If the action does not produce the requested output, then that
// output
// will be omitted from the list. The server is free to arrange the
// output
@@ -446,40 +457,32 @@
// the action, which
// can be retrieved from the
// ContentAddressableStorage.
- // See `stderr_raw` for when this will be set.
StderrDigest *BuildBazelRemoteExecutionV2Digest `json:"stderrDigest,omitempty"`
- // StderrRaw: The standard error buffer of the action. The server will
- // determine, based
- // on the size of the buffer, whether to return it in raw form or to
- // return
- // a digest in `stderr_digest` that points to the buffer. If neither is
- // set,
- // then the buffer is empty. The client SHOULD NOT assume it will get
- // one of
- // the raw buffer or a digest on any given request and should be
- // prepared to
- // handle either.
+ // StderrRaw: The standard error buffer of the action. The server SHOULD
+ // NOT inline
+ // stderr unless requested by the client in
+ // the
+ // GetActionResultRequest
+ // message. The server MAY omit inlining, even if requested, and MUST do
+ // so if inlining
+ // would cause the response to exceed message size limits.
StderrRaw string `json:"stderrRaw,omitempty"`
// StdoutDigest: The digest for a blob containing the standard output of
// the action, which
// can be retrieved from the
// ContentAddressableStorage.
- // See `stdout_raw` for when this will be set.
StdoutDigest *BuildBazelRemoteExecutionV2Digest `json:"stdoutDigest,omitempty"`
- // StdoutRaw: The standard output buffer of the action. The server will
- // determine, based
- // on the size of the buffer, whether to return it in raw form or to
- // return
- // a digest in `stdout_digest` that points to the buffer. If neither is
- // set,
- // then the buffer is empty. The client SHOULD NOT assume it will get
- // one of
- // the raw buffer or a digest on any given request and should be
- // prepared to
- // handle either.
+ // StdoutRaw: The standard output buffer of the action. The server
+ // SHOULD NOT inline
+ // stdout unless requested by the client in
+ // the
+ // GetActionResultRequest
+ // message. The server MAY omit inlining, even if requested, and MUST do
+ // so if inlining
+ // would cause the response to exceed message size limits.
StdoutRaw string `json:"stdoutRaw,omitempty"`
// ForceSendFields is a list of field names (e.g. "ExecutionMetadata")
@@ -573,7 +576,9 @@
//
// An output directory cannot be duplicated or have the same path as any
// of
- // the listed output files.
+ // the listed output files. An output directory is allowed to be a
+ // parent of
+ // another output directory.
//
// Directories leading up to the output directories (but not the
// output
@@ -624,6 +629,8 @@
// the client SHOULD ensure that running the action on any such worker
// will
// have the same result.
+ // A detailed lexicon for this can be found in the accompanying
+ // platform.md.
Platform *BuildBazelRemoteExecutionV2Platform `json:"platform,omitempty"`
// WorkingDirectory: The working directory, relative to the input root,
@@ -797,6 +804,14 @@
// Multiple levels of directory hierarchy may not be collapsed.
// * Each child in the directory must have a unique path segment (file
// name).
+// Note that while the API itself is case-sensitive, the environment
+// where
+// the Action is executed may or may not be case-sensitive. That is,
+// it is
+// legal to call the API with a Directory that has both "Foo" and
+// "foo" as
+// children, but the Action may be rejected by the remote system upon
+// execution.
// * The files, directories and symlinks in the directory must each be
// sorted
// in lexicographical order by path. The path strings must be sorted
@@ -930,8 +945,10 @@
// being executed.
ActionDigest *BuildBazelRemoteExecutionV2Digest `json:"actionDigest,omitempty"`
+ // Stage: The current stage of execution.
+ //
// Possible values:
- // "UNKNOWN"
+ // "UNKNOWN" - Invalid value.
// "CACHE_CHECK" - Checking the result against the cache.
// "QUEUED" - Currently idle, awaiting a free machine to execute.
// "EXECUTING" - Currently being executed by a worker.
@@ -1238,9 +1255,17 @@
// output in an `ActionResult`. It allows a full file path rather
// than
// only a name.
-//
-// `OutputFile` is binary-compatible with `FileNode`.
type BuildBazelRemoteExecutionV2OutputFile struct {
+ // Contents: The contents of the file if inlining was requested. The
+ // server SHOULD NOT inline
+ // file contents unless requested by the client in
+ // the
+ // GetActionResultRequest
+ // message. The server MAY omit inlining, even if requested, and MUST do
+ // so if inlining
+ // would cause the response to exceed message size limits.
+ Contents string `json:"contents,omitempty"`
+
// Digest: The digest of the file's content.
Digest *BuildBazelRemoteExecutionV2Digest `json:"digest,omitempty"`
@@ -1254,7 +1279,7 @@
// relative path, it MUST NOT begin with a leading forward slash.
Path string `json:"path,omitempty"`
- // ForceSendFields is a list of field names (e.g. "Digest") to
+ // ForceSendFields is a list of field names (e.g. "Contents") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
@@ -1262,8 +1287,8 @@
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
- // NullFields is a list of field names (e.g. "Digest") to include in API
- // requests with the JSON null value. By default, fields with empty
+ // NullFields is a list of field names (e.g. "Contents") 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.
@@ -1432,7 +1457,18 @@
// canonical proto serialization:
//
// * name: `build.bazel.remote.execution.v2.requestmetadata-bin`
-// * contents: the base64 encoded binary `RequestMetadata` message.
+// * contents: the base64 encoded binary `RequestMetadata`
+// message.
+// Note: the gRPC library serializes binary headers encoded in base 64
+// by
+// default
+// (https://github.com/grpc/grpc/blob/master/doc/PROTOCOL-HTTP2.md#reques
+// ts).
+// Therefore, if the gRPC library is used to pass/retrieve
+// this
+// metadata, the user may ignore the base64 encoding and assume it is
+// simply
+// serialized as a binary message.
type BuildBazelRemoteExecutionV2RequestMetadata struct {
// ActionId: An identifier that ties multiple requests to the same
// action.
@@ -2132,11 +2168,39 @@
}
type GoogleDevtoolsRemotebuildexecutionAdminV1alphaListWorkerPoolsRequest struct {
+ // Filter: Optional. A filter to constrain the pools returned. Filters
+ // have the form:
+ //
+ // <field> <operator> <value> [[AND|OR] <field> <operator>
+ // <value>]...
+ //
+ // <field> is the path for a field or map key in the Pool proto
+ // message.
+ // e.g. "configuration.disk_size_gb" or
+ // "configuration.labels.key".
+ // <operator> can be one of "<", "<=", ">=", ">", "=", "!=", ":".
+ // ":" is a HAS operation for strings and repeated primitive
+ // fields.
+ // <value> is the value to test, case-insensitive for strings. "*"
+ // stands for
+ // any value and can be used to test for key presence.
+ // Parenthesis determine AND/OR precedence. In space separated
+ // restrictions,
+ // AND is implicit, e.g. "a = b x = y" is equivalent to "a = b AND x =
+ // y".
+ //
+ // Example filter:
+ // configuration.labels.key1 = * AND (state = RUNNING OR state =
+ // UPDATING)
+ //
+ // This field is currently ignored in all requests.
+ Filter string `json:"filter,omitempty"`
+
// Parent: Resource name of the instance.
// Format: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.
Parent string `json:"parent,omitempty"`
- // ForceSendFields is a list of field names (e.g. "Parent") to
+ // ForceSendFields is a list of field names (e.g. "Filter") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
@@ -2144,7 +2208,7 @@
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
- // NullFields is a list of field names (e.g. "Parent") to include in API
+ // NullFields is a list of field names (e.g. "Filter") 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
@@ -2247,6 +2311,17 @@
// Currently only `pd-standard` is supported.
DiskType string `json:"diskType,omitempty"`
+ // Labels: Labels associated with the workers.
+ // Label keys and values can be no longer than 63 characters, can only
+ // contain
+ // lowercase letters, numeric characters, underscores and
+ // dashes.
+ // International letters are permitted. Keys must start with a letter
+ // but
+ // values are optional.
+ // This field is currently ignored in all requests.
+ Labels map[string]string `json:"labels,omitempty"`
+
// MachineType: Required. Machine type of the worker, such as
// `n1-standard-2`.
// See https://cloud.google.com/compute/docs/machine-types for a list
diff --git a/remotebuildexecution/v1alpha/remotebuildexecution-api.json b/remotebuildexecution/v1alpha/remotebuildexecution-api.json
index 7041752..7d77e8d 100644
--- a/remotebuildexecution/v1alpha/remotebuildexecution-api.json
+++ b/remotebuildexecution/v1alpha/remotebuildexecution-api.json
@@ -302,6 +302,11 @@
"parent"
],
"parameters": {
+ "filter": {
+ "description": "Optional. A filter to constrain the pools returned. Filters have the form:\n\n\u003cfield\u003e \u003coperator\u003e \u003cvalue\u003e [[AND|OR] \u003cfield\u003e \u003coperator\u003e \u003cvalue\u003e]...\n\n\u003cfield\u003e is the path for a field or map key in the Pool proto message.\ne.g. \"configuration.disk_size_gb\" or \"configuration.labels.key\".\n\u003coperator\u003e can be one of \"\u003c\", \"\u003c=\", \"\u003e=\", \"\u003e\", \"=\", \"!=\", \":\".\n\":\" is a HAS operation for strings and repeated primitive fields.\n\u003cvalue\u003e is the value to test, case-insensitive for strings. \"*\" stands for\nany value and can be used to test for key presence.\nParenthesis determine AND/OR precedence. In space separated restrictions,\nAND is implicit, e.g. \"a = b x = y\" is equivalent to \"a = b AND x = y\".\n\nExample filter:\nconfiguration.labels.key1 = * AND (state = RUNNING OR state = UPDATING)\n\nThis field is currently ignored in all requests.",
+ "location": "query",
+ "type": "string"
+ },
"parent": {
"description": "Resource name of the instance.\nFormat: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.",
"location": "path",
@@ -382,7 +387,7 @@
}
}
},
- "revision": "20190604",
+ "revision": "20190612",
"rootUrl": "https://admin-remotebuildexecution.googleapis.com/",
"schemas": {
"BuildBazelRemoteExecutionV2Action": {
@@ -394,7 +399,7 @@
"description": "The digest of the Command\nto run, which MUST be present in the\nContentAddressableStorage."
},
"doNotCache": {
- "description": "If true, then the `Action`'s result cannot be cached.",
+ "description": "If true, then the `Action`'s result cannot be cached, and in-flight\nrequests for the same `Action` may not be merged.",
"type": "boolean"
},
"inputRootDigest": {
@@ -423,28 +428,28 @@
"type": "integer"
},
"outputDirectories": {
- "description": "The output directories of the action. For each output directory requested\nin the `output_directories` field of the Action, if the corresponding\ndirectory existed after the action completed, a single entry will be\npresent in the output list, which will contain the digest of a\nTree message containing the\ndirectory tree, and the path equal exactly to the corresponding Action\noutput_directories member.\n\nAs an example, suppose the Action had an output directory `a/b/dir` and the\nexecution produced the following contents in `a/b/dir`: a file named `bar`\nand a directory named `foo` with an executable file named `baz`. Then,\noutput_directory will contain (hashes shortened for readability):\n\n```json\n// OutputDirectory proto:\n{\n path: \"a/b/dir\"\n tree_digest: {\n hash: \"4a73bc9d03...\",\n size: 55\n }\n}\n// Tree proto with hash \"4a73bc9d03...\" and size 55:\n{\n root: {\n files: [\n {\n name: \"bar\",\n digest: {\n hash: \"4a73bc9d03...\",\n size: 65534\n }\n }\n ],\n directories: [\n {\n name: \"foo\",\n digest: {\n hash: \"4cf2eda940...\",\n size: 43\n }\n }\n ]\n }\n children : {\n // (Directory proto with hash \"4cf2eda940...\" and size 43)\n files: [\n {\n name: \"baz\",\n digest: {\n hash: \"b2c941073e...\",\n size: 1294,\n },\n is_executable: true\n }\n ]\n }\n}\n```",
+ "description": "The output directories of the action. For each output directory requested\nin the `output_directories` field of the Action, if the corresponding\ndirectory existed after the action completed, a single entry will be\npresent in the output list, which will contain the digest of a\nTree message containing the\ndirectory tree, and the path equal exactly to the corresponding Action\noutput_directories member.\n\nAs an example, suppose the Action had an output directory `a/b/dir` and the\nexecution produced the following contents in `a/b/dir`: a file named `bar`\nand a directory named `foo` with an executable file named `baz`. Then,\noutput_directory will contain (hashes shortened for readability):\n\n```json\n// OutputDirectory proto:\n{\n path: \"a/b/dir\"\n tree_digest: {\n hash: \"4a73bc9d03...\",\n size: 55\n }\n}\n// Tree proto with hash \"4a73bc9d03...\" and size 55:\n{\n root: {\n files: [\n {\n name: \"bar\",\n digest: {\n hash: \"4a73bc9d03...\",\n size: 65534\n }\n }\n ],\n directories: [\n {\n name: \"foo\",\n digest: {\n hash: \"4cf2eda940...\",\n size: 43\n }\n }\n ]\n }\n children : {\n // (Directory proto with hash \"4cf2eda940...\" and size 43)\n files: [\n {\n name: \"baz\",\n digest: {\n hash: \"b2c941073e...\",\n size: 1294,\n },\n is_executable: true\n }\n ]\n }\n}\n```\nIf an output of the same name was found, but was not a directory, the\nserver will return a FAILED_PRECONDITION.",
"items": {
"$ref": "BuildBazelRemoteExecutionV2OutputDirectory"
},
"type": "array"
},
"outputDirectorySymlinks": {
- "description": "The output directories of the action that are symbolic links to other\ndirectories. Those may be links to other output directories, or input\ndirectories, or even absolute paths outside of the working directory,\nif the server supports\nSymlinkAbsolutePathStrategy.ALLOWED.\nFor each output directory requested in the `output_directories` field of\nthe Action, if the directory file existed after\nthe action completed, a single entry will be present either in this field,\nor in the `output_directories` field, if the directory was not a symbolic link.\n\nIf the action does not produce the requested output, or produces a\nfile where a directory is expected or vice versa, then that output\nwill be omitted from the list. The server is free to arrange the output\nlist as desired; clients MUST NOT assume that the output list is sorted.",
+ "description": "The output directories of the action that are symbolic links to other\ndirectories. Those may be links to other output directories, or input\ndirectories, or even absolute paths outside of the working directory,\nif the server supports\nSymlinkAbsolutePathStrategy.ALLOWED.\nFor each output directory requested in the `output_directories` field of\nthe Action, if the directory existed after the action completed, a\nsingle entry will be present either in this field, or in the\n`output_directories` field, if the directory was not a symbolic link.\n\nIf an output of the same name was found, but was a symbolic link to a file\ninstead of a directory, the server will return a FAILED_PRECONDITION.\nIf the action does not produce the requested output, then that output\nwill be omitted from the list. The server is free to arrange the output\nlist as desired; clients MUST NOT assume that the output list is sorted.",
"items": {
"$ref": "BuildBazelRemoteExecutionV2OutputSymlink"
},
"type": "array"
},
"outputFileSymlinks": {
- "description": "The output files of the action that are symbolic links to other files. Those\nmay be links to other output files, or input files, or even absolute paths\noutside of the working directory, if the server supports\nSymlinkAbsolutePathStrategy.ALLOWED.\nFor each output file requested in the `output_files` field of the Action,\nif the corresponding file existed after\nthe action completed, a single entry will be present either in this field,\nor in the `output_files` field, if the file was not a symbolic link.\n\nIf the action does not produce the requested output, or produces a\ndirectory where a regular file is expected or vice versa, then that output\nwill be omitted from the list. The server is free to arrange the output\nlist as desired; clients MUST NOT assume that the output list is sorted.",
+ "description": "The output files of the action that are symbolic links to other files. Those\nmay be links to other output files, or input files, or even absolute paths\noutside of the working directory, if the server supports\nSymlinkAbsolutePathStrategy.ALLOWED.\nFor each output file requested in the `output_files` field of the Action,\nif the corresponding file existed after\nthe action completed, a single entry will be present either in this field,\nor in the `output_files` field, if the file was not a symbolic link.\n\nIf an output symbolic link of the same name was found, but its target\ntype was not a regular file, the server will return a FAILED_PRECONDITION.\nIf the action does not produce the requested output, then that output\nwill be omitted from the list. The server is free to arrange the output\nlist as desired; clients MUST NOT assume that the output list is sorted.",
"items": {
"$ref": "BuildBazelRemoteExecutionV2OutputSymlink"
},
"type": "array"
},
"outputFiles": {
- "description": "The output files of the action. For each output file requested in the\n`output_files` field of the Action, if the corresponding file existed after\nthe action completed, a single entry will be present either in this field,\nor in the output_file_symlinks field, if the file was a symbolic link to\nanother file.\n\nIf the action does not produce the requested output, or produces a\ndirectory where a regular file is expected or vice versa, then that output\nwill be omitted from the list. The server is free to arrange the output\nlist as desired; clients MUST NOT assume that the output list is sorted.",
+ "description": "The output files of the action. For each output file requested in the\n`output_files` field of the Action, if the corresponding file existed after\nthe action completed, a single entry will be present either in this field,\nor the `output_file_symlinks` field if the file was a symbolic link to\nanother file.\n\nIf an output of the same name was found, but was a directory rather\nthan a regular file, the server will return a FAILED_PRECONDITION.\nIf the action does not produce the requested output, then that output\nwill be omitted from the list. The server is free to arrange the output\nlist as desired; clients MUST NOT assume that the output list is sorted.",
"items": {
"$ref": "BuildBazelRemoteExecutionV2OutputFile"
},
@@ -452,19 +457,19 @@
},
"stderrDigest": {
"$ref": "BuildBazelRemoteExecutionV2Digest",
- "description": "The digest for a blob containing the standard error of the action, which\ncan be retrieved from the\nContentAddressableStorage.\nSee `stderr_raw` for when this will be set."
+ "description": "The digest for a blob containing the standard error of the action, which\ncan be retrieved from the\nContentAddressableStorage."
},
"stderrRaw": {
- "description": "The standard error buffer of the action. The server will determine, based\non the size of the buffer, whether to return it in raw form or to return\na digest in `stderr_digest` that points to the buffer. If neither is set,\nthen the buffer is empty. The client SHOULD NOT assume it will get one of\nthe raw buffer or a digest on any given request and should be prepared to\nhandle either.",
+ "description": "The standard error buffer of the action. The server SHOULD NOT inline\nstderr unless requested by the client in the\nGetActionResultRequest\nmessage. The server MAY omit inlining, even if requested, and MUST do so if inlining\nwould cause the response to exceed message size limits.",
"format": "byte",
"type": "string"
},
"stdoutDigest": {
"$ref": "BuildBazelRemoteExecutionV2Digest",
- "description": "The digest for a blob containing the standard output of the action, which\ncan be retrieved from the\nContentAddressableStorage.\nSee `stdout_raw` for when this will be set."
+ "description": "The digest for a blob containing the standard output of the action, which\ncan be retrieved from the\nContentAddressableStorage."
},
"stdoutRaw": {
- "description": "The standard output buffer of the action. The server will determine, based\non the size of the buffer, whether to return it in raw form or to return\na digest in `stdout_digest` that points to the buffer. If neither is set,\nthen the buffer is empty. The client SHOULD NOT assume it will get one of\nthe raw buffer or a digest on any given request and should be prepared to\nhandle either.",
+ "description": "The standard output buffer of the action. The server SHOULD NOT inline\nstdout unless requested by the client in the\nGetActionResultRequest\nmessage. The server MAY omit inlining, even if requested, and MUST do so if inlining\nwould cause the response to exceed message size limits.",
"format": "byte",
"type": "string"
}
@@ -490,7 +495,7 @@
"type": "array"
},
"outputDirectories": {
- "description": "A list of the output directories that the client expects to retrieve from\nthe action. Only the listed directories will be returned (an entire\ndirectory structure will be returned as a\nTree message digest, see\nOutputDirectory), as\nwell as files listed in `output_files`. Other files or directories that\nmay be created during command execution are discarded.\n\nThe paths are relative to the working directory of the action execution.\nThe paths are specified using a single forward slash (`/`) as a path\nseparator, even if the execution platform natively uses a different\nseparator. The path MUST NOT include a trailing slash, nor a leading slash,\nbeing a relative path. The special value of empty string is allowed,\nalthough not recommended, and can be used to capture the entire working\ndirectory tree, including inputs.\n\nIn order to ensure consistent hashing of the same Action, the output paths\nMUST be sorted lexicographically by code point (or, equivalently, by UTF-8\nbytes).\n\nAn output directory cannot be duplicated or have the same path as any of\nthe listed output files.\n\nDirectories leading up to the output directories (but not the output\ndirectories themselves) are created by the worker prior to execution, even\nif they are not explicitly part of the input root.",
+ "description": "A list of the output directories that the client expects to retrieve from\nthe action. Only the listed directories will be returned (an entire\ndirectory structure will be returned as a\nTree message digest, see\nOutputDirectory), as\nwell as files listed in `output_files`. Other files or directories that\nmay be created during command execution are discarded.\n\nThe paths are relative to the working directory of the action execution.\nThe paths are specified using a single forward slash (`/`) as a path\nseparator, even if the execution platform natively uses a different\nseparator. The path MUST NOT include a trailing slash, nor a leading slash,\nbeing a relative path. The special value of empty string is allowed,\nalthough not recommended, and can be used to capture the entire working\ndirectory tree, including inputs.\n\nIn order to ensure consistent hashing of the same Action, the output paths\nMUST be sorted lexicographically by code point (or, equivalently, by UTF-8\nbytes).\n\nAn output directory cannot be duplicated or have the same path as any of\nthe listed output files. An output directory is allowed to be a parent of\nanother output directory.\n\nDirectories leading up to the output directories (but not the output\ndirectories themselves) are created by the worker prior to execution, even\nif they are not explicitly part of the input root.",
"items": {
"type": "string"
},
@@ -505,7 +510,7 @@
},
"platform": {
"$ref": "BuildBazelRemoteExecutionV2Platform",
- "description": "The platform requirements for the execution environment. The server MAY\nchoose to execute the action on any worker satisfying the requirements, so\nthe client SHOULD ensure that running the action on any such worker will\nhave the same result."
+ "description": "The platform requirements for the execution environment. The server MAY\nchoose to execute the action on any worker satisfying the requirements, so\nthe client SHOULD ensure that running the action on any such worker will\nhave the same result.\nA detailed lexicon for this can be found in the accompanying platform.md."
},
"workingDirectory": {
"description": "The working directory, relative to the input root, for the command to run\nin. It must be a directory which exists in the input tree. If it is left\nempty, then the action is run in the input root.",
@@ -546,7 +551,7 @@
"type": "object"
},
"BuildBazelRemoteExecutionV2Directory": {
- "description": "A `Directory` represents a directory node in a file tree, containing zero or\nmore children FileNodes,\nDirectoryNodes and\nSymlinkNodes.\nEach `Node` contains its name in the directory, either the digest of its\ncontent (either a file blob or a `Directory` proto) or a symlink target, as\nwell as possibly some metadata about the file or directory.\n\nIn order to ensure that two equivalent directory trees hash to the same\nvalue, the following restrictions MUST be obeyed when constructing a\na `Directory`:\n\n* Every child in the directory must have a path of exactly one segment.\n Multiple levels of directory hierarchy may not be collapsed.\n* Each child in the directory must have a unique path segment (file name).\n* The files, directories and symlinks in the directory must each be sorted\n in lexicographical order by path. The path strings must be sorted by code\n point, equivalently, by UTF-8 bytes.\n\nA `Directory` that obeys the restrictions is said to be in canonical form.\n\nAs an example, the following could be used for a file named `bar` and a\ndirectory named `foo` with an executable file named `baz` (hashes shortened\nfor readability):\n\n```json\n// (Directory proto)\n{\n files: [\n {\n name: \"bar\",\n digest: {\n hash: \"4a73bc9d03...\",\n size: 65534\n }\n }\n ],\n directories: [\n {\n name: \"foo\",\n digest: {\n hash: \"4cf2eda940...\",\n size: 43\n }\n }\n ]\n}\n\n// (Directory proto with hash \"4cf2eda940...\" and size 43)\n{\n files: [\n {\n name: \"baz\",\n digest: {\n hash: \"b2c941073e...\",\n size: 1294,\n },\n is_executable: true\n }\n ]\n}\n```",
+ "description": "A `Directory` represents a directory node in a file tree, containing zero or\nmore children FileNodes,\nDirectoryNodes and\nSymlinkNodes.\nEach `Node` contains its name in the directory, either the digest of its\ncontent (either a file blob or a `Directory` proto) or a symlink target, as\nwell as possibly some metadata about the file or directory.\n\nIn order to ensure that two equivalent directory trees hash to the same\nvalue, the following restrictions MUST be obeyed when constructing a\na `Directory`:\n\n* Every child in the directory must have a path of exactly one segment.\n Multiple levels of directory hierarchy may not be collapsed.\n* Each child in the directory must have a unique path segment (file name).\n Note that while the API itself is case-sensitive, the environment where\n the Action is executed may or may not be case-sensitive. That is, it is\n legal to call the API with a Directory that has both \"Foo\" and \"foo\" as\n children, but the Action may be rejected by the remote system upon\n execution.\n* The files, directories and symlinks in the directory must each be sorted\n in lexicographical order by path. The path strings must be sorted by code\n point, equivalently, by UTF-8 bytes.\n\nA `Directory` that obeys the restrictions is said to be in canonical form.\n\nAs an example, the following could be used for a file named `bar` and a\ndirectory named `foo` with an executable file named `baz` (hashes shortened\nfor readability):\n\n```json\n// (Directory proto)\n{\n files: [\n {\n name: \"bar\",\n digest: {\n hash: \"4a73bc9d03...\",\n size: 65534\n }\n }\n ],\n directories: [\n {\n name: \"foo\",\n digest: {\n hash: \"4cf2eda940...\",\n size: 43\n }\n }\n ]\n}\n\n// (Directory proto with hash \"4cf2eda940...\" and size 43)\n{\n files: [\n {\n name: \"baz\",\n digest: {\n hash: \"b2c941073e...\",\n size: 1294,\n },\n is_executable: true\n }\n ]\n}\n```",
"id": "BuildBazelRemoteExecutionV2Directory",
"properties": {
"directories": {
@@ -597,6 +602,7 @@
"description": "The digest of the Action\nbeing executed."
},
"stage": {
+ "description": "The current stage of execution.",
"enum": [
"UNKNOWN",
"CACHE_CHECK",
@@ -605,7 +611,7 @@
"COMPLETED"
],
"enumDescriptions": [
- "",
+ "Invalid value.",
"Checking the result against the cache.",
"Currently idle, awaiting a free machine to execute.",
"Currently being executed by a worker.",
@@ -760,9 +766,14 @@
"type": "object"
},
"BuildBazelRemoteExecutionV2OutputFile": {
- "description": "An `OutputFile` is similar to a\nFileNode, but it is used as an\noutput in an `ActionResult`. It allows a full file path rather than\nonly a name.\n\n`OutputFile` is binary-compatible with `FileNode`.",
+ "description": "An `OutputFile` is similar to a\nFileNode, but it is used as an\noutput in an `ActionResult`. It allows a full file path rather than\nonly a name.",
"id": "BuildBazelRemoteExecutionV2OutputFile",
"properties": {
+ "contents": {
+ "description": "The contents of the file if inlining was requested. The server SHOULD NOT inline\nfile contents unless requested by the client in the\nGetActionResultRequest\nmessage. The server MAY omit inlining, even if requested, and MUST do so if inlining\nwould cause the response to exceed message size limits.",
+ "format": "byte",
+ "type": "string"
+ },
"digest": {
"$ref": "BuildBazelRemoteExecutionV2Digest",
"description": "The digest of the file's content."
@@ -823,7 +834,7 @@
"type": "object"
},
"BuildBazelRemoteExecutionV2RequestMetadata": {
- "description": "An optional Metadata to attach to any RPC request to tell the server about an\nexternal context of the request. The server may use this for logging or other\npurposes. To use it, the client attaches the header to the call using the\ncanonical proto serialization:\n\n* name: `build.bazel.remote.execution.v2.requestmetadata-bin`\n* contents: the base64 encoded binary `RequestMetadata` message.",
+ "description": "An optional Metadata to attach to any RPC request to tell the server about an\nexternal context of the request. The server may use this for logging or other\npurposes. To use it, the client attaches the header to the call using the\ncanonical proto serialization:\n\n* name: `build.bazel.remote.execution.v2.requestmetadata-bin`\n* contents: the base64 encoded binary `RequestMetadata` message.\nNote: the gRPC library serializes binary headers encoded in base 64 by\ndefault (https://github.com/grpc/grpc/blob/master/doc/PROTOCOL-HTTP2.md#requests).\nTherefore, if the gRPC library is used to pass/retrieve this\nmetadata, the user may ignore the base64 encoding and assume it is simply\nserialized as a binary message.",
"id": "BuildBazelRemoteExecutionV2RequestMetadata",
"properties": {
"actionId": {
@@ -1163,6 +1174,10 @@
"GoogleDevtoolsRemotebuildexecutionAdminV1alphaListWorkerPoolsRequest": {
"id": "GoogleDevtoolsRemotebuildexecutionAdminV1alphaListWorkerPoolsRequest",
"properties": {
+ "filter": {
+ "description": "Optional. A filter to constrain the pools returned. Filters have the form:\n\n\u003cfield\u003e \u003coperator\u003e \u003cvalue\u003e [[AND|OR] \u003cfield\u003e \u003coperator\u003e \u003cvalue\u003e]...\n\n\u003cfield\u003e is the path for a field or map key in the Pool proto message.\ne.g. \"configuration.disk_size_gb\" or \"configuration.labels.key\".\n\u003coperator\u003e can be one of \"\u003c\", \"\u003c=\", \"\u003e=\", \"\u003e\", \"=\", \"!=\", \":\".\n\":\" is a HAS operation for strings and repeated primitive fields.\n\u003cvalue\u003e is the value to test, case-insensitive for strings. \"*\" stands for\nany value and can be used to test for key presence.\nParenthesis determine AND/OR precedence. In space separated restrictions,\nAND is implicit, e.g. \"a = b x = y\" is equivalent to \"a = b AND x = y\".\n\nExample filter:\nconfiguration.labels.key1 = * AND (state = RUNNING OR state = UPDATING)\n\nThis field is currently ignored in all requests.",
+ "type": "string"
+ },
"parent": {
"description": "Resource name of the instance.\nFormat: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.",
"type": "string"
@@ -1212,6 +1227,13 @@
"description": "Required. Disk Type to use for the worker.\nSee [Storage\noptions](https://cloud.google.com/compute/docs/disks/#introduction).\nCurrently only `pd-standard` is supported.",
"type": "string"
},
+ "labels": {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "description": "Labels associated with the workers.\nLabel keys and values can be no longer than 63 characters, can only contain\nlowercase letters, numeric characters, underscores and dashes.\nInternational letters are permitted. Keys must start with a letter but\nvalues are optional.\nThis field is currently ignored in all requests.",
+ "type": "object"
+ },
"machineType": {
"description": "Required. Machine type of the worker, such as `n1-standard-2`.\nSee https://cloud.google.com/compute/docs/machine-types for a list of\nsupported machine types. Note that `f1-micro` and `g1-small` are not yet\nsupported.",
"type": "string"
diff --git a/remotebuildexecution/v1alpha/remotebuildexecution-gen.go b/remotebuildexecution/v1alpha/remotebuildexecution-gen.go
index 4490bc6..7aa1f26 100644
--- a/remotebuildexecution/v1alpha/remotebuildexecution-gen.go
+++ b/remotebuildexecution/v1alpha/remotebuildexecution-gen.go
@@ -212,7 +212,9 @@
// ContentAddressableStorage.
CommandDigest *BuildBazelRemoteExecutionV2Digest `json:"commandDigest,omitempty"`
- // DoNotCache: If true, then the `Action`'s result cannot be cached.
+ // DoNotCache: If true, then the `Action`'s result cannot be cached, and
+ // in-flight
+ // requests for the same `Action` may not be merged.
DoNotCache bool `json:"doNotCache,omitempty"`
// InputRootDigest: The digest of the root
@@ -357,6 +359,9 @@
// }
// }
// ```
+ // If an output of the same name was found, but was not a directory,
+ // the
+ // server will return a FAILED_PRECONDITION.
OutputDirectories []*BuildBazelRemoteExecutionV2OutputDirectory `json:"outputDirectories,omitempty"`
// OutputDirectorySymlinks: The output directories of the action that
@@ -369,15 +374,18 @@
// SymlinkAbsolutePathStrategy.ALLOWED.
// For each output directory requested in the `output_directories` field
// of
- // the Action, if the directory file existed after
- // the action completed, a single entry will be present either in this
- // field,
- // or in the `output_directories` field, if the directory was not a
- // symbolic link.
- //
- // If the action does not produce the requested output, or produces
+ // the Action, if the directory existed after the action completed,
// a
- // file where a directory is expected or vice versa, then that
+ // single entry will be present either in this field, or in
+ // the
+ // `output_directories` field, if the directory was not a symbolic
+ // link.
+ //
+ // If an output of the same name was found, but was a symbolic link to a
+ // file
+ // instead of a directory, the server will return a
+ // FAILED_PRECONDITION.
+ // If the action does not produce the requested output, then that
// output
// will be omitted from the list. The server is free to arrange the
// output
@@ -400,9 +408,11 @@
// or in the `output_files` field, if the file was not a symbolic
// link.
//
- // If the action does not produce the requested output, or produces
- // a
- // directory where a regular file is expected or vice versa, then that
+ // If an output symbolic link of the same name was found, but its
+ // target
+ // type was not a regular file, the server will return a
+ // FAILED_PRECONDITION.
+ // If the action does not produce the requested output, then that
// output
// will be omitted from the list. The server is free to arrange the
// output
@@ -416,13 +426,14 @@
// after
// the action completed, a single entry will be present either in this
// field,
- // or in the output_file_symlinks field, if the file was a symbolic link
+ // or the `output_file_symlinks` field if the file was a symbolic link
// to
// another file.
//
- // If the action does not produce the requested output, or produces
- // a
- // directory where a regular file is expected or vice versa, then that
+ // If an output of the same name was found, but was a directory
+ // rather
+ // than a regular file, the server will return a FAILED_PRECONDITION.
+ // If the action does not produce the requested output, then that
// output
// will be omitted from the list. The server is free to arrange the
// output
@@ -434,40 +445,32 @@
// the action, which
// can be retrieved from the
// ContentAddressableStorage.
- // See `stderr_raw` for when this will be set.
StderrDigest *BuildBazelRemoteExecutionV2Digest `json:"stderrDigest,omitempty"`
- // StderrRaw: The standard error buffer of the action. The server will
- // determine, based
- // on the size of the buffer, whether to return it in raw form or to
- // return
- // a digest in `stderr_digest` that points to the buffer. If neither is
- // set,
- // then the buffer is empty. The client SHOULD NOT assume it will get
- // one of
- // the raw buffer or a digest on any given request and should be
- // prepared to
- // handle either.
+ // StderrRaw: The standard error buffer of the action. The server SHOULD
+ // NOT inline
+ // stderr unless requested by the client in
+ // the
+ // GetActionResultRequest
+ // message. The server MAY omit inlining, even if requested, and MUST do
+ // so if inlining
+ // would cause the response to exceed message size limits.
StderrRaw string `json:"stderrRaw,omitempty"`
// StdoutDigest: The digest for a blob containing the standard output of
// the action, which
// can be retrieved from the
// ContentAddressableStorage.
- // See `stdout_raw` for when this will be set.
StdoutDigest *BuildBazelRemoteExecutionV2Digest `json:"stdoutDigest,omitempty"`
- // StdoutRaw: The standard output buffer of the action. The server will
- // determine, based
- // on the size of the buffer, whether to return it in raw form or to
- // return
- // a digest in `stdout_digest` that points to the buffer. If neither is
- // set,
- // then the buffer is empty. The client SHOULD NOT assume it will get
- // one of
- // the raw buffer or a digest on any given request and should be
- // prepared to
- // handle either.
+ // StdoutRaw: The standard output buffer of the action. The server
+ // SHOULD NOT inline
+ // stdout unless requested by the client in
+ // the
+ // GetActionResultRequest
+ // message. The server MAY omit inlining, even if requested, and MUST do
+ // so if inlining
+ // would cause the response to exceed message size limits.
StdoutRaw string `json:"stdoutRaw,omitempty"`
// ForceSendFields is a list of field names (e.g. "ExecutionMetadata")
@@ -561,7 +564,9 @@
//
// An output directory cannot be duplicated or have the same path as any
// of
- // the listed output files.
+ // the listed output files. An output directory is allowed to be a
+ // parent of
+ // another output directory.
//
// Directories leading up to the output directories (but not the
// output
@@ -612,6 +617,8 @@
// the client SHOULD ensure that running the action on any such worker
// will
// have the same result.
+ // A detailed lexicon for this can be found in the accompanying
+ // platform.md.
Platform *BuildBazelRemoteExecutionV2Platform `json:"platform,omitempty"`
// WorkingDirectory: The working directory, relative to the input root,
@@ -785,6 +792,14 @@
// Multiple levels of directory hierarchy may not be collapsed.
// * Each child in the directory must have a unique path segment (file
// name).
+// Note that while the API itself is case-sensitive, the environment
+// where
+// the Action is executed may or may not be case-sensitive. That is,
+// it is
+// legal to call the API with a Directory that has both "Foo" and
+// "foo" as
+// children, but the Action may be rejected by the remote system upon
+// execution.
// * The files, directories and symlinks in the directory must each be
// sorted
// in lexicographical order by path. The path strings must be sorted
@@ -918,8 +933,10 @@
// being executed.
ActionDigest *BuildBazelRemoteExecutionV2Digest `json:"actionDigest,omitempty"`
+ // Stage: The current stage of execution.
+ //
// Possible values:
- // "UNKNOWN"
+ // "UNKNOWN" - Invalid value.
// "CACHE_CHECK" - Checking the result against the cache.
// "QUEUED" - Currently idle, awaiting a free machine to execute.
// "EXECUTING" - Currently being executed by a worker.
@@ -1226,9 +1243,17 @@
// output in an `ActionResult`. It allows a full file path rather
// than
// only a name.
-//
-// `OutputFile` is binary-compatible with `FileNode`.
type BuildBazelRemoteExecutionV2OutputFile struct {
+ // Contents: The contents of the file if inlining was requested. The
+ // server SHOULD NOT inline
+ // file contents unless requested by the client in
+ // the
+ // GetActionResultRequest
+ // message. The server MAY omit inlining, even if requested, and MUST do
+ // so if inlining
+ // would cause the response to exceed message size limits.
+ Contents string `json:"contents,omitempty"`
+
// Digest: The digest of the file's content.
Digest *BuildBazelRemoteExecutionV2Digest `json:"digest,omitempty"`
@@ -1242,7 +1267,7 @@
// relative path, it MUST NOT begin with a leading forward slash.
Path string `json:"path,omitempty"`
- // ForceSendFields is a list of field names (e.g. "Digest") to
+ // ForceSendFields is a list of field names (e.g. "Contents") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
@@ -1250,8 +1275,8 @@
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
- // NullFields is a list of field names (e.g. "Digest") to include in API
- // requests with the JSON null value. By default, fields with empty
+ // NullFields is a list of field names (e.g. "Contents") 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.
@@ -1420,7 +1445,18 @@
// canonical proto serialization:
//
// * name: `build.bazel.remote.execution.v2.requestmetadata-bin`
-// * contents: the base64 encoded binary `RequestMetadata` message.
+// * contents: the base64 encoded binary `RequestMetadata`
+// message.
+// Note: the gRPC library serializes binary headers encoded in base 64
+// by
+// default
+// (https://github.com/grpc/grpc/blob/master/doc/PROTOCOL-HTTP2.md#reques
+// ts).
+// Therefore, if the gRPC library is used to pass/retrieve
+// this
+// metadata, the user may ignore the base64 encoding and assume it is
+// simply
+// serialized as a binary message.
type BuildBazelRemoteExecutionV2RequestMetadata struct {
// ActionId: An identifier that ties multiple requests to the same
// action.
@@ -2096,11 +2132,39 @@
}
type GoogleDevtoolsRemotebuildexecutionAdminV1alphaListWorkerPoolsRequest struct {
+ // Filter: Optional. A filter to constrain the pools returned. Filters
+ // have the form:
+ //
+ // <field> <operator> <value> [[AND|OR] <field> <operator>
+ // <value>]...
+ //
+ // <field> is the path for a field or map key in the Pool proto
+ // message.
+ // e.g. "configuration.disk_size_gb" or
+ // "configuration.labels.key".
+ // <operator> can be one of "<", "<=", ">=", ">", "=", "!=", ":".
+ // ":" is a HAS operation for strings and repeated primitive
+ // fields.
+ // <value> is the value to test, case-insensitive for strings. "*"
+ // stands for
+ // any value and can be used to test for key presence.
+ // Parenthesis determine AND/OR precedence. In space separated
+ // restrictions,
+ // AND is implicit, e.g. "a = b x = y" is equivalent to "a = b AND x =
+ // y".
+ //
+ // Example filter:
+ // configuration.labels.key1 = * AND (state = RUNNING OR state =
+ // UPDATING)
+ //
+ // This field is currently ignored in all requests.
+ Filter string `json:"filter,omitempty"`
+
// Parent: Resource name of the instance.
// Format: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.
Parent string `json:"parent,omitempty"`
- // ForceSendFields is a list of field names (e.g. "Parent") to
+ // ForceSendFields is a list of field names (e.g. "Filter") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
@@ -2108,7 +2172,7 @@
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
- // NullFields is a list of field names (e.g. "Parent") to include in API
+ // NullFields is a list of field names (e.g. "Filter") 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
@@ -2215,6 +2279,17 @@
// Currently only `pd-standard` is supported.
DiskType string `json:"diskType,omitempty"`
+ // Labels: Labels associated with the workers.
+ // Label keys and values can be no longer than 63 characters, can only
+ // contain
+ // lowercase letters, numeric characters, underscores and
+ // dashes.
+ // International letters are permitted. Keys must start with a letter
+ // but
+ // values are optional.
+ // This field is currently ignored in all requests.
+ Labels map[string]string `json:"labels,omitempty"`
+
// MachineType: Required. Machine type of the worker, such as
// `n1-standard-2`.
// See https://cloud.google.com/compute/docs/machine-types for a list
@@ -5080,6 +5155,37 @@
return c
}
+// Filter sets the optional parameter "filter": A filter to constrain
+// the pools returned. Filters have the form:
+//
+// <field> <operator> <value> [[AND|OR] <field> <operator>
+// <value>]...
+//
+// <field> is the path for a field or map key in the Pool proto
+// message.
+// e.g. "configuration.disk_size_gb" or
+// "configuration.labels.key".
+// <operator> can be one of "<", "<=", ">=", ">", "=", "!=", ":".
+// ":" is a HAS operation for strings and repeated primitive
+// fields.
+// <value> is the value to test, case-insensitive for strings. "*"
+// stands for
+// any value and can be used to test for key presence.
+// Parenthesis determine AND/OR precedence. In space separated
+// restrictions,
+// AND is implicit, e.g. "a = b x = y" is equivalent to "a = b AND x =
+// y".
+//
+// Example filter:
+// configuration.labels.key1 = * AND (state = RUNNING OR state =
+// UPDATING)
+//
+// This field is currently ignored in all requests.
+func (c *ProjectsInstancesWorkerpoolsListCall) Filter(filter string) *ProjectsInstancesWorkerpoolsListCall {
+ c.urlParams_.Set("filter", filter)
+ return c
+}
+
// Fields allows partial responses to be retrieved. See
// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
// for more information.
@@ -5189,6 +5295,11 @@
// "parent"
// ],
// "parameters": {
+ // "filter": {
+ // "description": "Optional. A filter to constrain the pools returned. Filters have the form:\n\n\u003cfield\u003e \u003coperator\u003e \u003cvalue\u003e [[AND|OR] \u003cfield\u003e \u003coperator\u003e \u003cvalue\u003e]...\n\n\u003cfield\u003e is the path for a field or map key in the Pool proto message.\ne.g. \"configuration.disk_size_gb\" or \"configuration.labels.key\".\n\u003coperator\u003e can be one of \"\u003c\", \"\u003c=\", \"\u003e=\", \"\u003e\", \"=\", \"!=\", \":\".\n\":\" is a HAS operation for strings and repeated primitive fields.\n\u003cvalue\u003e is the value to test, case-insensitive for strings. \"*\" stands for\nany value and can be used to test for key presence.\nParenthesis determine AND/OR precedence. In space separated restrictions,\nAND is implicit, e.g. \"a = b x = y\" is equivalent to \"a = b AND x = y\".\n\nExample filter:\nconfiguration.labels.key1 = * AND (state = RUNNING OR state = UPDATING)\n\nThis field is currently ignored in all requests.",
+ // "location": "query",
+ // "type": "string"
+ // },
// "parent": {
// "description": "Resource name of the instance.\nFormat: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.",
// "location": "path",
diff --git a/remotebuildexecution/v2/remotebuildexecution-api.json b/remotebuildexecution/v2/remotebuildexecution-api.json
index 9ccbe11..0648d65 100644
--- a/remotebuildexecution/v2/remotebuildexecution-api.json
+++ b/remotebuildexecution/v2/remotebuildexecution-api.json
@@ -107,7 +107,7 @@
"actionResults": {
"methods": {
"get": {
- "description": "Retrieve a cached execution result.\n\nErrors:\n\n* `NOT_FOUND`: The requested `ActionResult` is not in the cache.",
+ "description": "Retrieve a cached execution result.\n\nImplementations SHOULD ensure that any blobs referenced from the\nContentAddressableStorage\nare available at the time of returning the\nActionResult and will be\nfor some period of time afterwards. The TTLs of the referenced blobs SHOULD be increased\nif necessary and applicable.\n\nErrors:\n\n* `NOT_FOUND`: The requested `ActionResult` is not in the cache.",
"flatPath": "v2/{v2Id}/actionResults/{hash}/{sizeBytes}",
"httpMethod": "GET",
"id": "remotebuildexecution.actionResults.get",
@@ -123,6 +123,22 @@
"required": true,
"type": "string"
},
+ "inlineOutputFiles": {
+ "description": "A hint to the server to inline the contents of the listed output files.\nEach path needs to exactly match one path in `output_files` in the\nCommand message.",
+ "location": "query",
+ "repeated": true,
+ "type": "string"
+ },
+ "inlineStderr": {
+ "description": "A hint to the server to request inlining stderr in the\nActionResult message.",
+ "location": "query",
+ "type": "boolean"
+ },
+ "inlineStdout": {
+ "description": "A hint to the server to request inlining stdout in the\nActionResult message.",
+ "location": "query",
+ "type": "boolean"
+ },
"instanceName": {
"description": "The instance of the execution system to operate against. A server may\nsupport multiple instances of the execution system (with their own workers,\nstorage, caches, etc.). The server MAY require use of this field to select\nbetween them in an implementation-defined fashion, otherwise it can be\nomitted.",
"location": "path",
@@ -403,7 +419,7 @@
"v2": {
"methods": {
"getCapabilities": {
- "description": "GetCapabilities returns the server capabilities configuration.",
+ "description": "GetCapabilities returns the server capabilities configuration of the\nremote endpoint.\nOnly the capabilities of the services supported by the endpoint will\nbe returned:\n* Execution + CAS + Action Cache endpoints should return both\n CacheCapabilities and ExecutionCapabilities.\n* Execution only endpoints should return ExecutionCapabilities.\n* CAS + Action Cache only endpoints should return CacheCapabilities.",
"flatPath": "v2/{v2Id}/capabilities",
"httpMethod": "GET",
"id": "remotebuildexecution.getCapabilities",
@@ -430,7 +446,7 @@
}
}
},
- "revision": "20190604",
+ "revision": "20190612",
"rootUrl": "https://remotebuildexecution.googleapis.com/",
"schemas": {
"BuildBazelRemoteExecutionV2Action": {
@@ -442,7 +458,7 @@
"description": "The digest of the Command\nto run, which MUST be present in the\nContentAddressableStorage."
},
"doNotCache": {
- "description": "If true, then the `Action`'s result cannot be cached.",
+ "description": "If true, then the `Action`'s result cannot be cached, and in-flight\nrequests for the same `Action` may not be merged.",
"type": "boolean"
},
"inputRootDigest": {
@@ -481,28 +497,28 @@
"type": "integer"
},
"outputDirectories": {
- "description": "The output directories of the action. For each output directory requested\nin the `output_directories` field of the Action, if the corresponding\ndirectory existed after the action completed, a single entry will be\npresent in the output list, which will contain the digest of a\nTree message containing the\ndirectory tree, and the path equal exactly to the corresponding Action\noutput_directories member.\n\nAs an example, suppose the Action had an output directory `a/b/dir` and the\nexecution produced the following contents in `a/b/dir`: a file named `bar`\nand a directory named `foo` with an executable file named `baz`. Then,\noutput_directory will contain (hashes shortened for readability):\n\n```json\n// OutputDirectory proto:\n{\n path: \"a/b/dir\"\n tree_digest: {\n hash: \"4a73bc9d03...\",\n size: 55\n }\n}\n// Tree proto with hash \"4a73bc9d03...\" and size 55:\n{\n root: {\n files: [\n {\n name: \"bar\",\n digest: {\n hash: \"4a73bc9d03...\",\n size: 65534\n }\n }\n ],\n directories: [\n {\n name: \"foo\",\n digest: {\n hash: \"4cf2eda940...\",\n size: 43\n }\n }\n ]\n }\n children : {\n // (Directory proto with hash \"4cf2eda940...\" and size 43)\n files: [\n {\n name: \"baz\",\n digest: {\n hash: \"b2c941073e...\",\n size: 1294,\n },\n is_executable: true\n }\n ]\n }\n}\n```",
+ "description": "The output directories of the action. For each output directory requested\nin the `output_directories` field of the Action, if the corresponding\ndirectory existed after the action completed, a single entry will be\npresent in the output list, which will contain the digest of a\nTree message containing the\ndirectory tree, and the path equal exactly to the corresponding Action\noutput_directories member.\n\nAs an example, suppose the Action had an output directory `a/b/dir` and the\nexecution produced the following contents in `a/b/dir`: a file named `bar`\nand a directory named `foo` with an executable file named `baz`. Then,\noutput_directory will contain (hashes shortened for readability):\n\n```json\n// OutputDirectory proto:\n{\n path: \"a/b/dir\"\n tree_digest: {\n hash: \"4a73bc9d03...\",\n size: 55\n }\n}\n// Tree proto with hash \"4a73bc9d03...\" and size 55:\n{\n root: {\n files: [\n {\n name: \"bar\",\n digest: {\n hash: \"4a73bc9d03...\",\n size: 65534\n }\n }\n ],\n directories: [\n {\n name: \"foo\",\n digest: {\n hash: \"4cf2eda940...\",\n size: 43\n }\n }\n ]\n }\n children : {\n // (Directory proto with hash \"4cf2eda940...\" and size 43)\n files: [\n {\n name: \"baz\",\n digest: {\n hash: \"b2c941073e...\",\n size: 1294,\n },\n is_executable: true\n }\n ]\n }\n}\n```\nIf an output of the same name was found, but was not a directory, the\nserver will return a FAILED_PRECONDITION.",
"items": {
"$ref": "BuildBazelRemoteExecutionV2OutputDirectory"
},
"type": "array"
},
"outputDirectorySymlinks": {
- "description": "The output directories of the action that are symbolic links to other\ndirectories. Those may be links to other output directories, or input\ndirectories, or even absolute paths outside of the working directory,\nif the server supports\nSymlinkAbsolutePathStrategy.ALLOWED.\nFor each output directory requested in the `output_directories` field of\nthe Action, if the directory file existed after\nthe action completed, a single entry will be present either in this field,\nor in the `output_directories` field, if the directory was not a symbolic link.\n\nIf the action does not produce the requested output, or produces a\nfile where a directory is expected or vice versa, then that output\nwill be omitted from the list. The server is free to arrange the output\nlist as desired; clients MUST NOT assume that the output list is sorted.",
+ "description": "The output directories of the action that are symbolic links to other\ndirectories. Those may be links to other output directories, or input\ndirectories, or even absolute paths outside of the working directory,\nif the server supports\nSymlinkAbsolutePathStrategy.ALLOWED.\nFor each output directory requested in the `output_directories` field of\nthe Action, if the directory existed after the action completed, a\nsingle entry will be present either in this field, or in the\n`output_directories` field, if the directory was not a symbolic link.\n\nIf an output of the same name was found, but was a symbolic link to a file\ninstead of a directory, the server will return a FAILED_PRECONDITION.\nIf the action does not produce the requested output, then that output\nwill be omitted from the list. The server is free to arrange the output\nlist as desired; clients MUST NOT assume that the output list is sorted.",
"items": {
"$ref": "BuildBazelRemoteExecutionV2OutputSymlink"
},
"type": "array"
},
"outputFileSymlinks": {
- "description": "The output files of the action that are symbolic links to other files. Those\nmay be links to other output files, or input files, or even absolute paths\noutside of the working directory, if the server supports\nSymlinkAbsolutePathStrategy.ALLOWED.\nFor each output file requested in the `output_files` field of the Action,\nif the corresponding file existed after\nthe action completed, a single entry will be present either in this field,\nor in the `output_files` field, if the file was not a symbolic link.\n\nIf the action does not produce the requested output, or produces a\ndirectory where a regular file is expected or vice versa, then that output\nwill be omitted from the list. The server is free to arrange the output\nlist as desired; clients MUST NOT assume that the output list is sorted.",
+ "description": "The output files of the action that are symbolic links to other files. Those\nmay be links to other output files, or input files, or even absolute paths\noutside of the working directory, if the server supports\nSymlinkAbsolutePathStrategy.ALLOWED.\nFor each output file requested in the `output_files` field of the Action,\nif the corresponding file existed after\nthe action completed, a single entry will be present either in this field,\nor in the `output_files` field, if the file was not a symbolic link.\n\nIf an output symbolic link of the same name was found, but its target\ntype was not a regular file, the server will return a FAILED_PRECONDITION.\nIf the action does not produce the requested output, then that output\nwill be omitted from the list. The server is free to arrange the output\nlist as desired; clients MUST NOT assume that the output list is sorted.",
"items": {
"$ref": "BuildBazelRemoteExecutionV2OutputSymlink"
},
"type": "array"
},
"outputFiles": {
- "description": "The output files of the action. For each output file requested in the\n`output_files` field of the Action, if the corresponding file existed after\nthe action completed, a single entry will be present either in this field,\nor in the output_file_symlinks field, if the file was a symbolic link to\nanother file.\n\nIf the action does not produce the requested output, or produces a\ndirectory where a regular file is expected or vice versa, then that output\nwill be omitted from the list. The server is free to arrange the output\nlist as desired; clients MUST NOT assume that the output list is sorted.",
+ "description": "The output files of the action. For each output file requested in the\n`output_files` field of the Action, if the corresponding file existed after\nthe action completed, a single entry will be present either in this field,\nor the `output_file_symlinks` field if the file was a symbolic link to\nanother file.\n\nIf an output of the same name was found, but was a directory rather\nthan a regular file, the server will return a FAILED_PRECONDITION.\nIf the action does not produce the requested output, then that output\nwill be omitted from the list. The server is free to arrange the output\nlist as desired; clients MUST NOT assume that the output list is sorted.",
"items": {
"$ref": "BuildBazelRemoteExecutionV2OutputFile"
},
@@ -510,19 +526,19 @@
},
"stderrDigest": {
"$ref": "BuildBazelRemoteExecutionV2Digest",
- "description": "The digest for a blob containing the standard error of the action, which\ncan be retrieved from the\nContentAddressableStorage.\nSee `stderr_raw` for when this will be set."
+ "description": "The digest for a blob containing the standard error of the action, which\ncan be retrieved from the\nContentAddressableStorage."
},
"stderrRaw": {
- "description": "The standard error buffer of the action. The server will determine, based\non the size of the buffer, whether to return it in raw form or to return\na digest in `stderr_digest` that points to the buffer. If neither is set,\nthen the buffer is empty. The client SHOULD NOT assume it will get one of\nthe raw buffer or a digest on any given request and should be prepared to\nhandle either.",
+ "description": "The standard error buffer of the action. The server SHOULD NOT inline\nstderr unless requested by the client in the\nGetActionResultRequest\nmessage. The server MAY omit inlining, even if requested, and MUST do so if inlining\nwould cause the response to exceed message size limits.",
"format": "byte",
"type": "string"
},
"stdoutDigest": {
"$ref": "BuildBazelRemoteExecutionV2Digest",
- "description": "The digest for a blob containing the standard output of the action, which\ncan be retrieved from the\nContentAddressableStorage.\nSee `stdout_raw` for when this will be set."
+ "description": "The digest for a blob containing the standard output of the action, which\ncan be retrieved from the\nContentAddressableStorage."
},
"stdoutRaw": {
- "description": "The standard output buffer of the action. The server will determine, based\non the size of the buffer, whether to return it in raw form or to return\na digest in `stdout_digest` that points to the buffer. If neither is set,\nthen the buffer is empty. The client SHOULD NOT assume it will get one of\nthe raw buffer or a digest on any given request and should be prepared to\nhandle either.",
+ "description": "The standard output buffer of the action. The server SHOULD NOT inline\nstdout unless requested by the client in the\nGetActionResultRequest\nmessage. The server MAY omit inlining, even if requested, and MUST do so if inlining\nwould cause the response to exceed message size limits.",
"format": "byte",
"type": "string"
}
@@ -558,7 +574,7 @@
"type": "object"
},
"BuildBazelRemoteExecutionV2BatchReadBlobsResponseResponse": {
- "description": "A response corresponding to a single blob that the client tried to upload.",
+ "description": "A response corresponding to a single blob that the client tried to download.",
"id": "BuildBazelRemoteExecutionV2BatchReadBlobsResponseResponse",
"properties": {
"data": {
@@ -654,14 +670,16 @@
"It is an error for the server to return this value.",
"The Sha-256 digest function.",
"The Sha-1 digest function.",
- "The MD5 digest function."
+ "The MD5 digest function.",
+ "The Microsoft \"VSO-Hash\" paged SHA256 digest function.\nSee https://github.com/microsoft/BuildXL/blob/master/Documentation/Specs/PagedHash.md ."
],
"items": {
"enum": [
"UNKNOWN",
"SHA256",
"SHA1",
- "MD5"
+ "MD5",
+ "VSO"
],
"type": "string"
},
@@ -680,7 +698,7 @@
"ALLOWED"
],
"enumDescriptions": [
- "",
+ "Invalid value.",
"Server will return an `INVALID_ARGUMENT` on input symlinks with absolute\ntargets.\nIf an action tries to create an output symlink with an absolute target, a\n`FAILED_PRECONDITION` will be returned.",
"Server will allow symlink targets to escape the input root tree, possibly\nresulting in non-hermetic builds."
],
@@ -708,7 +726,7 @@
"type": "array"
},
"outputDirectories": {
- "description": "A list of the output directories that the client expects to retrieve from\nthe action. Only the listed directories will be returned (an entire\ndirectory structure will be returned as a\nTree message digest, see\nOutputDirectory), as\nwell as files listed in `output_files`. Other files or directories that\nmay be created during command execution are discarded.\n\nThe paths are relative to the working directory of the action execution.\nThe paths are specified using a single forward slash (`/`) as a path\nseparator, even if the execution platform natively uses a different\nseparator. The path MUST NOT include a trailing slash, nor a leading slash,\nbeing a relative path. The special value of empty string is allowed,\nalthough not recommended, and can be used to capture the entire working\ndirectory tree, including inputs.\n\nIn order to ensure consistent hashing of the same Action, the output paths\nMUST be sorted lexicographically by code point (or, equivalently, by UTF-8\nbytes).\n\nAn output directory cannot be duplicated or have the same path as any of\nthe listed output files.\n\nDirectories leading up to the output directories (but not the output\ndirectories themselves) are created by the worker prior to execution, even\nif they are not explicitly part of the input root.",
+ "description": "A list of the output directories that the client expects to retrieve from\nthe action. Only the listed directories will be returned (an entire\ndirectory structure will be returned as a\nTree message digest, see\nOutputDirectory), as\nwell as files listed in `output_files`. Other files or directories that\nmay be created during command execution are discarded.\n\nThe paths are relative to the working directory of the action execution.\nThe paths are specified using a single forward slash (`/`) as a path\nseparator, even if the execution platform natively uses a different\nseparator. The path MUST NOT include a trailing slash, nor a leading slash,\nbeing a relative path. The special value of empty string is allowed,\nalthough not recommended, and can be used to capture the entire working\ndirectory tree, including inputs.\n\nIn order to ensure consistent hashing of the same Action, the output paths\nMUST be sorted lexicographically by code point (or, equivalently, by UTF-8\nbytes).\n\nAn output directory cannot be duplicated or have the same path as any of\nthe listed output files. An output directory is allowed to be a parent of\nanother output directory.\n\nDirectories leading up to the output directories (but not the output\ndirectories themselves) are created by the worker prior to execution, even\nif they are not explicitly part of the input root.",
"items": {
"type": "string"
},
@@ -723,7 +741,7 @@
},
"platform": {
"$ref": "BuildBazelRemoteExecutionV2Platform",
- "description": "The platform requirements for the execution environment. The server MAY\nchoose to execute the action on any worker satisfying the requirements, so\nthe client SHOULD ensure that running the action on any such worker will\nhave the same result."
+ "description": "The platform requirements for the execution environment. The server MAY\nchoose to execute the action on any worker satisfying the requirements, so\nthe client SHOULD ensure that running the action on any such worker will\nhave the same result.\nA detailed lexicon for this can be found in the accompanying platform.md."
},
"workingDirectory": {
"description": "The working directory, relative to the input root, for the command to run\nin. It must be a directory which exists in the input tree. If it is left\nempty, then the action is run in the input root.",
@@ -764,7 +782,7 @@
"type": "object"
},
"BuildBazelRemoteExecutionV2Directory": {
- "description": "A `Directory` represents a directory node in a file tree, containing zero or\nmore children FileNodes,\nDirectoryNodes and\nSymlinkNodes.\nEach `Node` contains its name in the directory, either the digest of its\ncontent (either a file blob or a `Directory` proto) or a symlink target, as\nwell as possibly some metadata about the file or directory.\n\nIn order to ensure that two equivalent directory trees hash to the same\nvalue, the following restrictions MUST be obeyed when constructing a\na `Directory`:\n\n* Every child in the directory must have a path of exactly one segment.\n Multiple levels of directory hierarchy may not be collapsed.\n* Each child in the directory must have a unique path segment (file name).\n* The files, directories and symlinks in the directory must each be sorted\n in lexicographical order by path. The path strings must be sorted by code\n point, equivalently, by UTF-8 bytes.\n\nA `Directory` that obeys the restrictions is said to be in canonical form.\n\nAs an example, the following could be used for a file named `bar` and a\ndirectory named `foo` with an executable file named `baz` (hashes shortened\nfor readability):\n\n```json\n// (Directory proto)\n{\n files: [\n {\n name: \"bar\",\n digest: {\n hash: \"4a73bc9d03...\",\n size: 65534\n }\n }\n ],\n directories: [\n {\n name: \"foo\",\n digest: {\n hash: \"4cf2eda940...\",\n size: 43\n }\n }\n ]\n}\n\n// (Directory proto with hash \"4cf2eda940...\" and size 43)\n{\n files: [\n {\n name: \"baz\",\n digest: {\n hash: \"b2c941073e...\",\n size: 1294,\n },\n is_executable: true\n }\n ]\n}\n```",
+ "description": "A `Directory` represents a directory node in a file tree, containing zero or\nmore children FileNodes,\nDirectoryNodes and\nSymlinkNodes.\nEach `Node` contains its name in the directory, either the digest of its\ncontent (either a file blob or a `Directory` proto) or a symlink target, as\nwell as possibly some metadata about the file or directory.\n\nIn order to ensure that two equivalent directory trees hash to the same\nvalue, the following restrictions MUST be obeyed when constructing a\na `Directory`:\n\n* Every child in the directory must have a path of exactly one segment.\n Multiple levels of directory hierarchy may not be collapsed.\n* Each child in the directory must have a unique path segment (file name).\n Note that while the API itself is case-sensitive, the environment where\n the Action is executed may or may not be case-sensitive. That is, it is\n legal to call the API with a Directory that has both \"Foo\" and \"foo\" as\n children, but the Action may be rejected by the remote system upon\n execution.\n* The files, directories and symlinks in the directory must each be sorted\n in lexicographical order by path. The path strings must be sorted by code\n point, equivalently, by UTF-8 bytes.\n\nA `Directory` that obeys the restrictions is said to be in canonical form.\n\nAs an example, the following could be used for a file named `bar` and a\ndirectory named `foo` with an executable file named `baz` (hashes shortened\nfor readability):\n\n```json\n// (Directory proto)\n{\n files: [\n {\n name: \"bar\",\n digest: {\n hash: \"4a73bc9d03...\",\n size: 65534\n }\n }\n ],\n directories: [\n {\n name: \"foo\",\n digest: {\n hash: \"4cf2eda940...\",\n size: 43\n }\n }\n ]\n}\n\n// (Directory proto with hash \"4cf2eda940...\" and size 43)\n{\n files: [\n {\n name: \"baz\",\n digest: {\n hash: \"b2c941073e...\",\n size: 1294,\n },\n is_executable: true\n }\n ]\n}\n```",
"id": "BuildBazelRemoteExecutionV2Directory",
"properties": {
"directories": {
@@ -815,6 +833,7 @@
"description": "The digest of the Action\nbeing executed."
},
"stage": {
+ "description": "The current stage of execution.",
"enum": [
"UNKNOWN",
"CACHE_CHECK",
@@ -823,7 +842,7 @@
"COMPLETED"
],
"enumDescriptions": [
- "",
+ "Invalid value.",
"Checking the result against the cache.",
"Currently idle, awaiting a free machine to execute.",
"Currently being executed by a worker.",
@@ -859,7 +878,7 @@
"description": "An optional policy for the results of this execution in the remote cache.\nThe server will have a default policy if this is not provided.\nThis may be applied to both the ActionResult and the associated blobs."
},
"skipCacheLookup": {
- "description": "If true, the action will be executed anew even if its result was already\npresent in the cache. If false, the result may be served from the\nActionCache.",
+ "description": "If true, the action will be executed even if its result is already\npresent in the ActionCache.\nThe execution is still allowed to be merged with other in-flight executions\nof the same action, however - semantically, the service MUST only guarantee\nthat the results of an execution with this field set were not visible\nbefore the corresponding execution request was sent.\nNote that actions from execution requests setting this field set are still\neligible to be entered into the action cache upon completion, and services\nSHOULD overwrite any existing entries that may exist. This allows\nskip_cache_lookup requests to be used as a mechanism for replacing action\ncache entries that reference outputs no longer available or that are\npoisoned in any way.\nIf false, the result may be served from the action cache.",
"type": "boolean"
}
},
@@ -961,13 +980,15 @@
"UNKNOWN",
"SHA256",
"SHA1",
- "MD5"
+ "MD5",
+ "VSO"
],
"enumDescriptions": [
"It is an error for the server to return this value.",
"The Sha-256 digest function.",
"The Sha-1 digest function.",
- "The MD5 digest function."
+ "The MD5 digest function.",
+ "The Microsoft \"VSO-Hash\" paged SHA256 digest function.\nSee https://github.com/microsoft/BuildXL/blob/master/Documentation/Specs/PagedHash.md ."
],
"type": "string"
},
@@ -1090,9 +1111,14 @@
"type": "object"
},
"BuildBazelRemoteExecutionV2OutputFile": {
- "description": "An `OutputFile` is similar to a\nFileNode, but it is used as an\noutput in an `ActionResult`. It allows a full file path rather than\nonly a name.\n\n`OutputFile` is binary-compatible with `FileNode`.",
+ "description": "An `OutputFile` is similar to a\nFileNode, but it is used as an\noutput in an `ActionResult`. It allows a full file path rather than\nonly a name.",
"id": "BuildBazelRemoteExecutionV2OutputFile",
"properties": {
+ "contents": {
+ "description": "The contents of the file if inlining was requested. The server SHOULD NOT inline\nfile contents unless requested by the client in the\nGetActionResultRequest\nmessage. The server MAY omit inlining, even if requested, and MUST do so if inlining\nwould cause the response to exceed message size limits.",
+ "format": "byte",
+ "type": "string"
+ },
"digest": {
"$ref": "BuildBazelRemoteExecutionV2Digest",
"description": "The digest of the file's content."
@@ -1181,7 +1207,7 @@
"type": "object"
},
"BuildBazelRemoteExecutionV2RequestMetadata": {
- "description": "An optional Metadata to attach to any RPC request to tell the server about an\nexternal context of the request. The server may use this for logging or other\npurposes. To use it, the client attaches the header to the call using the\ncanonical proto serialization:\n\n* name: `build.bazel.remote.execution.v2.requestmetadata-bin`\n* contents: the base64 encoded binary `RequestMetadata` message.",
+ "description": "An optional Metadata to attach to any RPC request to tell the server about an\nexternal context of the request. The server may use this for logging or other\npurposes. To use it, the client attaches the header to the call using the\ncanonical proto serialization:\n\n* name: `build.bazel.remote.execution.v2.requestmetadata-bin`\n* contents: the base64 encoded binary `RequestMetadata` message.\nNote: the gRPC library serializes binary headers encoded in base 64 by\ndefault (https://github.com/grpc/grpc/blob/master/doc/PROTOCOL-HTTP2.md#requests).\nTherefore, if the gRPC library is used to pass/retrieve this\nmetadata, the user may ignore the base64 encoding and assume it is simply\nserialized as a binary message.",
"id": "BuildBazelRemoteExecutionV2RequestMetadata",
"properties": {
"actionId": {
@@ -1592,6 +1618,10 @@
"GoogleDevtoolsRemotebuildexecutionAdminV1alphaListWorkerPoolsRequest": {
"id": "GoogleDevtoolsRemotebuildexecutionAdminV1alphaListWorkerPoolsRequest",
"properties": {
+ "filter": {
+ "description": "Optional. A filter to constrain the pools returned. Filters have the form:\n\n\u003cfield\u003e \u003coperator\u003e \u003cvalue\u003e [[AND|OR] \u003cfield\u003e \u003coperator\u003e \u003cvalue\u003e]...\n\n\u003cfield\u003e is the path for a field or map key in the Pool proto message.\ne.g. \"configuration.disk_size_gb\" or \"configuration.labels.key\".\n\u003coperator\u003e can be one of \"\u003c\", \"\u003c=\", \"\u003e=\", \"\u003e\", \"=\", \"!=\", \":\".\n\":\" is a HAS operation for strings and repeated primitive fields.\n\u003cvalue\u003e is the value to test, case-insensitive for strings. \"*\" stands for\nany value and can be used to test for key presence.\nParenthesis determine AND/OR precedence. In space separated restrictions,\nAND is implicit, e.g. \"a = b x = y\" is equivalent to \"a = b AND x = y\".\n\nExample filter:\nconfiguration.labels.key1 = * AND (state = RUNNING OR state = UPDATING)\n\nThis field is currently ignored in all requests.",
+ "type": "string"
+ },
"parent": {
"description": "Resource name of the instance.\nFormat: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.",
"type": "string"
@@ -1641,6 +1671,13 @@
"description": "Required. Disk Type to use for the worker.\nSee [Storage\noptions](https://cloud.google.com/compute/docs/disks/#introduction).\nCurrently only `pd-standard` is supported.",
"type": "string"
},
+ "labels": {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "description": "Labels associated with the workers.\nLabel keys and values can be no longer than 63 characters, can only contain\nlowercase letters, numeric characters, underscores and dashes.\nInternational letters are permitted. Keys must start with a letter but\nvalues are optional.\nThis field is currently ignored in all requests.",
+ "type": "object"
+ },
"machineType": {
"description": "Required. Machine type of the worker, such as `n1-standard-2`.\nSee https://cloud.google.com/compute/docs/machine-types for a list of\nsupported machine types. Note that `f1-micro` and `g1-small` are not yet\nsupported.",
"type": "string"
diff --git a/remotebuildexecution/v2/remotebuildexecution-gen.go b/remotebuildexecution/v2/remotebuildexecution-gen.go
index 7b3adaf..f8d7094 100644
--- a/remotebuildexecution/v2/remotebuildexecution-gen.go
+++ b/remotebuildexecution/v2/remotebuildexecution-gen.go
@@ -224,7 +224,9 @@
// ContentAddressableStorage.
CommandDigest *BuildBazelRemoteExecutionV2Digest `json:"commandDigest,omitempty"`
- // DoNotCache: If true, then the `Action`'s result cannot be cached.
+ // DoNotCache: If true, then the `Action`'s result cannot be cached, and
+ // in-flight
+ // requests for the same `Action` may not be merged.
DoNotCache bool `json:"doNotCache,omitempty"`
// InputRootDigest: The digest of the root
@@ -397,6 +399,9 @@
// }
// }
// ```
+ // If an output of the same name was found, but was not a directory,
+ // the
+ // server will return a FAILED_PRECONDITION.
OutputDirectories []*BuildBazelRemoteExecutionV2OutputDirectory `json:"outputDirectories,omitempty"`
// OutputDirectorySymlinks: The output directories of the action that
@@ -409,15 +414,18 @@
// SymlinkAbsolutePathStrategy.ALLOWED.
// For each output directory requested in the `output_directories` field
// of
- // the Action, if the directory file existed after
- // the action completed, a single entry will be present either in this
- // field,
- // or in the `output_directories` field, if the directory was not a
- // symbolic link.
- //
- // If the action does not produce the requested output, or produces
+ // the Action, if the directory existed after the action completed,
// a
- // file where a directory is expected or vice versa, then that
+ // single entry will be present either in this field, or in
+ // the
+ // `output_directories` field, if the directory was not a symbolic
+ // link.
+ //
+ // If an output of the same name was found, but was a symbolic link to a
+ // file
+ // instead of a directory, the server will return a
+ // FAILED_PRECONDITION.
+ // If the action does not produce the requested output, then that
// output
// will be omitted from the list. The server is free to arrange the
// output
@@ -440,9 +448,11 @@
// or in the `output_files` field, if the file was not a symbolic
// link.
//
- // If the action does not produce the requested output, or produces
- // a
- // directory where a regular file is expected or vice versa, then that
+ // If an output symbolic link of the same name was found, but its
+ // target
+ // type was not a regular file, the server will return a
+ // FAILED_PRECONDITION.
+ // If the action does not produce the requested output, then that
// output
// will be omitted from the list. The server is free to arrange the
// output
@@ -456,13 +466,14 @@
// after
// the action completed, a single entry will be present either in this
// field,
- // or in the output_file_symlinks field, if the file was a symbolic link
+ // or the `output_file_symlinks` field if the file was a symbolic link
// to
// another file.
//
- // If the action does not produce the requested output, or produces
- // a
- // directory where a regular file is expected or vice versa, then that
+ // If an output of the same name was found, but was a directory
+ // rather
+ // than a regular file, the server will return a FAILED_PRECONDITION.
+ // If the action does not produce the requested output, then that
// output
// will be omitted from the list. The server is free to arrange the
// output
@@ -474,40 +485,32 @@
// the action, which
// can be retrieved from the
// ContentAddressableStorage.
- // See `stderr_raw` for when this will be set.
StderrDigest *BuildBazelRemoteExecutionV2Digest `json:"stderrDigest,omitempty"`
- // StderrRaw: The standard error buffer of the action. The server will
- // determine, based
- // on the size of the buffer, whether to return it in raw form or to
- // return
- // a digest in `stderr_digest` that points to the buffer. If neither is
- // set,
- // then the buffer is empty. The client SHOULD NOT assume it will get
- // one of
- // the raw buffer or a digest on any given request and should be
- // prepared to
- // handle either.
+ // StderrRaw: The standard error buffer of the action. The server SHOULD
+ // NOT inline
+ // stderr unless requested by the client in
+ // the
+ // GetActionResultRequest
+ // message. The server MAY omit inlining, even if requested, and MUST do
+ // so if inlining
+ // would cause the response to exceed message size limits.
StderrRaw string `json:"stderrRaw,omitempty"`
// StdoutDigest: The digest for a blob containing the standard output of
// the action, which
// can be retrieved from the
// ContentAddressableStorage.
- // See `stdout_raw` for when this will be set.
StdoutDigest *BuildBazelRemoteExecutionV2Digest `json:"stdoutDigest,omitempty"`
- // StdoutRaw: The standard output buffer of the action. The server will
- // determine, based
- // on the size of the buffer, whether to return it in raw form or to
- // return
- // a digest in `stdout_digest` that points to the buffer. If neither is
- // set,
- // then the buffer is empty. The client SHOULD NOT assume it will get
- // one of
- // the raw buffer or a digest on any given request and should be
- // prepared to
- // handle either.
+ // StdoutRaw: The standard output buffer of the action. The server
+ // SHOULD NOT inline
+ // stdout unless requested by the client in
+ // the
+ // GetActionResultRequest
+ // message. The server MAY omit inlining, even if requested, and MUST do
+ // so if inlining
+ // would cause the response to exceed message size limits.
StdoutRaw string `json:"stdoutRaw,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
@@ -603,7 +606,7 @@
}
// BuildBazelRemoteExecutionV2BatchReadBlobsResponseResponse: A response
-// corresponding to a single blob that the client tried to upload.
+// corresponding to a single blob that the client tried to download.
type BuildBazelRemoteExecutionV2BatchReadBlobsResponseResponse struct {
// Data: The raw binary data.
Data string `json:"data,omitempty"`
@@ -786,6 +789,10 @@
// "SHA256" - The Sha-256 digest function.
// "SHA1" - The Sha-1 digest function.
// "MD5" - The MD5 digest function.
+ // "VSO" - The Microsoft "VSO-Hash" paged SHA256 digest function.
+ // See
+ // https://github.com/microsoft/BuildXL/blob/master/Documentation/Specs/PagedHash.md
+ // .
DigestFunction []string `json:"digestFunction,omitempty"`
// MaxBatchTotalSizeBytes: Maximum total size of blobs to be
@@ -799,7 +806,7 @@
// supported.
//
// Possible values:
- // "UNKNOWN"
+ // "UNKNOWN" - Invalid value.
// "DISALLOWED" - Server will return an `INVALID_ARGUMENT` on input
// symlinks with absolute
// targets.
@@ -903,7 +910,9 @@
//
// An output directory cannot be duplicated or have the same path as any
// of
- // the listed output files.
+ // the listed output files. An output directory is allowed to be a
+ // parent of
+ // another output directory.
//
// Directories leading up to the output directories (but not the
// output
@@ -954,6 +963,8 @@
// the client SHOULD ensure that running the action on any such worker
// will
// have the same result.
+ // A detailed lexicon for this can be found in the accompanying
+ // platform.md.
Platform *BuildBazelRemoteExecutionV2Platform `json:"platform,omitempty"`
// WorkingDirectory: The working directory, relative to the input root,
@@ -1127,6 +1138,14 @@
// Multiple levels of directory hierarchy may not be collapsed.
// * Each child in the directory must have a unique path segment (file
// name).
+// Note that while the API itself is case-sensitive, the environment
+// where
+// the Action is executed may or may not be case-sensitive. That is,
+// it is
+// legal to call the API with a Directory that has both "Foo" and
+// "foo" as
+// children, but the Action may be rejected by the remote system upon
+// execution.
// * The files, directories and symlinks in the directory must each be
// sorted
// in lexicographical order by path. The path strings must be sorted
@@ -1260,8 +1279,10 @@
// being executed.
ActionDigest *BuildBazelRemoteExecutionV2Digest `json:"actionDigest,omitempty"`
+ // Stage: The current stage of execution.
+ //
// Possible values:
- // "UNKNOWN"
+ // "UNKNOWN" - Invalid value.
// "CACHE_CHECK" - Checking the result against the cache.
// "QUEUED" - Currently idle, awaiting a free machine to execute.
// "EXECUTING" - Currently being executed by a worker.
@@ -1322,11 +1343,28 @@
// blobs.
ResultsCachePolicy *BuildBazelRemoteExecutionV2ResultsCachePolicy `json:"resultsCachePolicy,omitempty"`
- // SkipCacheLookup: If true, the action will be executed anew even if
- // its result was already
- // present in the cache. If false, the result may be served from
- // the
- // ActionCache.
+ // SkipCacheLookup: If true, the action will be executed even if its
+ // result is already
+ // present in the ActionCache.
+ // The execution is still allowed to be merged with other in-flight
+ // executions
+ // of the same action, however - semantically, the service MUST only
+ // guarantee
+ // that the results of an execution with this field set were not
+ // visible
+ // before the corresponding execution request was sent.
+ // Note that actions from execution requests setting this field set are
+ // still
+ // eligible to be entered into the action cache upon completion, and
+ // services
+ // SHOULD overwrite any existing entries that may exist. This
+ // allows
+ // skip_cache_lookup requests to be used as a mechanism for replacing
+ // action
+ // cache entries that reference outputs no longer available or that
+ // are
+ // poisoned in any way.
+ // If false, the result may be served from the action cache.
SkipCacheLookup bool `json:"skipCacheLookup,omitempty"`
// ForceSendFields is a list of field names (e.g. "ActionDigest") to
@@ -1506,6 +1544,10 @@
// "SHA256" - The Sha-256 digest function.
// "SHA1" - The Sha-1 digest function.
// "MD5" - The MD5 digest function.
+ // "VSO" - The Microsoft "VSO-Hash" paged SHA256 digest function.
+ // See
+ // https://github.com/microsoft/BuildXL/blob/master/Documentation/Specs/PagedHash.md
+ // .
DigestFunction string `json:"digestFunction,omitempty"`
// ExecEnabled: Whether remote execution is enabled for the particular
@@ -1814,9 +1856,17 @@
// output in an `ActionResult`. It allows a full file path rather
// than
// only a name.
-//
-// `OutputFile` is binary-compatible with `FileNode`.
type BuildBazelRemoteExecutionV2OutputFile struct {
+ // Contents: The contents of the file if inlining was requested. The
+ // server SHOULD NOT inline
+ // file contents unless requested by the client in
+ // the
+ // GetActionResultRequest
+ // message. The server MAY omit inlining, even if requested, and MUST do
+ // so if inlining
+ // would cause the response to exceed message size limits.
+ Contents string `json:"contents,omitempty"`
+
// Digest: The digest of the file's content.
Digest *BuildBazelRemoteExecutionV2Digest `json:"digest,omitempty"`
@@ -1830,7 +1880,7 @@
// relative path, it MUST NOT begin with a leading forward slash.
Path string `json:"path,omitempty"`
- // ForceSendFields is a list of field names (e.g. "Digest") to
+ // ForceSendFields is a list of field names (e.g. "Contents") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
@@ -1838,8 +1888,8 @@
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
- // NullFields is a list of field names (e.g. "Digest") to include in API
- // requests with the JSON null value. By default, fields with empty
+ // NullFields is a list of field names (e.g. "Contents") 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.
@@ -2068,7 +2118,18 @@
// canonical proto serialization:
//
// * name: `build.bazel.remote.execution.v2.requestmetadata-bin`
-// * contents: the base64 encoded binary `RequestMetadata` message.
+// * contents: the base64 encoded binary `RequestMetadata`
+// message.
+// Note: the gRPC library serializes binary headers encoded in base 64
+// by
+// default
+// (https://github.com/grpc/grpc/blob/master/doc/PROTOCOL-HTTP2.md#reques
+// ts).
+// Therefore, if the gRPC library is used to pass/retrieve
+// this
+// metadata, the user may ignore the base64 encoding and assume it is
+// simply
+// serialized as a binary message.
type BuildBazelRemoteExecutionV2RequestMetadata struct {
// ActionId: An identifier that ties multiple requests to the same
// action.
@@ -2873,11 +2934,39 @@
}
type GoogleDevtoolsRemotebuildexecutionAdminV1alphaListWorkerPoolsRequest struct {
+ // Filter: Optional. A filter to constrain the pools returned. Filters
+ // have the form:
+ //
+ // <field> <operator> <value> [[AND|OR] <field> <operator>
+ // <value>]...
+ //
+ // <field> is the path for a field or map key in the Pool proto
+ // message.
+ // e.g. "configuration.disk_size_gb" or
+ // "configuration.labels.key".
+ // <operator> can be one of "<", "<=", ">=", ">", "=", "!=", ":".
+ // ":" is a HAS operation for strings and repeated primitive
+ // fields.
+ // <value> is the value to test, case-insensitive for strings. "*"
+ // stands for
+ // any value and can be used to test for key presence.
+ // Parenthesis determine AND/OR precedence. In space separated
+ // restrictions,
+ // AND is implicit, e.g. "a = b x = y" is equivalent to "a = b AND x =
+ // y".
+ //
+ // Example filter:
+ // configuration.labels.key1 = * AND (state = RUNNING OR state =
+ // UPDATING)
+ //
+ // This field is currently ignored in all requests.
+ Filter string `json:"filter,omitempty"`
+
// Parent: Resource name of the instance.
// Format: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.
Parent string `json:"parent,omitempty"`
- // ForceSendFields is a list of field names (e.g. "Parent") to
+ // ForceSendFields is a list of field names (e.g. "Filter") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
@@ -2885,7 +2974,7 @@
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
- // NullFields is a list of field names (e.g. "Parent") to include in API
+ // NullFields is a list of field names (e.g. "Filter") 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
@@ -2988,6 +3077,17 @@
// Currently only `pd-standard` is supported.
DiskType string `json:"diskType,omitempty"`
+ // Labels: Labels associated with the workers.
+ // Label keys and values can be no longer than 63 characters, can only
+ // contain
+ // lowercase letters, numeric characters, underscores and
+ // dashes.
+ // International letters are permitted. Keys must start with a letter
+ // but
+ // values are optional.
+ // This field is currently ignored in all requests.
+ Labels map[string]string `json:"labels,omitempty"`
+
// MachineType: Required. Machine type of the worker, such as
// `n1-standard-2`.
// See https://cloud.google.com/compute/docs/machine-types for a list
@@ -4849,6 +4949,15 @@
// Get: Retrieve a cached execution result.
//
+// Implementations SHOULD ensure that any blobs referenced from
+// the
+// ContentAddressableStorage
+// are available at the time of returning the
+// ActionResult and will be
+// for some period of time afterwards. The TTLs of the referenced blobs
+// SHOULD be increased
+// if necessary and applicable.
+//
// Errors:
//
// * `NOT_FOUND`: The requested `ActionResult` is not in the cache.
@@ -4860,6 +4969,33 @@
return c
}
+// InlineOutputFiles sets the optional parameter "inlineOutputFiles": A
+// hint to the server to inline the contents of the listed output
+// files.
+// Each path needs to exactly match one path in `output_files` in
+// the
+// Command message.
+func (c *ActionResultsGetCall) InlineOutputFiles(inlineOutputFiles ...string) *ActionResultsGetCall {
+ c.urlParams_.SetMulti("inlineOutputFiles", append([]string{}, inlineOutputFiles...))
+ return c
+}
+
+// InlineStderr sets the optional parameter "inlineStderr": A hint to
+// the server to request inlining stderr in the
+// ActionResult message.
+func (c *ActionResultsGetCall) InlineStderr(inlineStderr bool) *ActionResultsGetCall {
+ c.urlParams_.Set("inlineStderr", fmt.Sprint(inlineStderr))
+ return c
+}
+
+// InlineStdout sets the optional parameter "inlineStdout": A hint to
+// the server to request inlining stdout in the
+// ActionResult message.
+func (c *ActionResultsGetCall) InlineStdout(inlineStdout bool) *ActionResultsGetCall {
+ c.urlParams_.Set("inlineStdout", fmt.Sprint(inlineStdout))
+ return c
+}
+
// Fields allows partial responses to be retrieved. See
// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
// for more information.
@@ -4961,7 +5097,7 @@
}
return ret, nil
// {
- // "description": "Retrieve a cached execution result.\n\nErrors:\n\n* `NOT_FOUND`: The requested `ActionResult` is not in the cache.",
+ // "description": "Retrieve a cached execution result.\n\nImplementations SHOULD ensure that any blobs referenced from the\nContentAddressableStorage\nare available at the time of returning the\nActionResult and will be\nfor some period of time afterwards. The TTLs of the referenced blobs SHOULD be increased\nif necessary and applicable.\n\nErrors:\n\n* `NOT_FOUND`: The requested `ActionResult` is not in the cache.",
// "flatPath": "v2/{v2Id}/actionResults/{hash}/{sizeBytes}",
// "httpMethod": "GET",
// "id": "remotebuildexecution.actionResults.get",
@@ -4977,6 +5113,22 @@
// "required": true,
// "type": "string"
// },
+ // "inlineOutputFiles": {
+ // "description": "A hint to the server to inline the contents of the listed output files.\nEach path needs to exactly match one path in `output_files` in the\nCommand message.",
+ // "location": "query",
+ // "repeated": true,
+ // "type": "string"
+ // },
+ // "inlineStderr": {
+ // "description": "A hint to the server to request inlining stderr in the\nActionResult message.",
+ // "location": "query",
+ // "type": "boolean"
+ // },
+ // "inlineStdout": {
+ // "description": "A hint to the server to request inlining stdout in the\nActionResult message.",
+ // "location": "query",
+ // "type": "boolean"
+ // },
// "instanceName": {
// "description": "The instance of the execution system to operate against. A server may\nsupport multiple instances of the execution system (with their own workers,\nstorage, caches, etc.). The server MAY require use of this field to select\nbetween them in an implementation-defined fashion, otherwise it can be\nomitted.",
// "location": "path",
@@ -6325,7 +6477,15 @@
}
// GetCapabilities: GetCapabilities returns the server capabilities
-// configuration.
+// configuration of the
+// remote endpoint.
+// Only the capabilities of the services supported by the endpoint
+// will
+// be returned:
+// * Execution + CAS + Action Cache endpoints should return both
+// CacheCapabilities and ExecutionCapabilities.
+// * Execution only endpoints should return ExecutionCapabilities.
+// * CAS + Action Cache only endpoints should return CacheCapabilities.
func (r *V2Service) GetCapabilities(instanceName string) *V2GetCapabilitiesCall {
c := &V2GetCapabilitiesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.instanceName = instanceName
@@ -6432,7 +6592,7 @@
}
return ret, nil
// {
- // "description": "GetCapabilities returns the server capabilities configuration.",
+ // "description": "GetCapabilities returns the server capabilities configuration of the\nremote endpoint.\nOnly the capabilities of the services supported by the endpoint will\nbe returned:\n* Execution + CAS + Action Cache endpoints should return both\n CacheCapabilities and ExecutionCapabilities.\n* Execution only endpoints should return ExecutionCapabilities.\n* CAS + Action Cache only endpoints should return CacheCapabilities.",
// "flatPath": "v2/{v2Id}/capabilities",
// "httpMethod": "GET",
// "id": "remotebuildexecution.getCapabilities",
diff --git a/servicecontrol/v1/servicecontrol-api.json b/servicecontrol/v1/servicecontrol-api.json
index 295109e..82ad104 100644
--- a/servicecontrol/v1/servicecontrol-api.json
+++ b/servicecontrol/v1/servicecontrol-api.json
@@ -196,7 +196,7 @@
}
}
},
- "revision": "20190509",
+ "revision": "20190607",
"rootUrl": "https://servicecontrol.googleapis.com/",
"schemas": {
"AllocateInfo": {
@@ -1572,7 +1572,7 @@
"type": "object"
},
"Status": {
- "description": "The `Status` type defines a logical error model that is suitable for\ndifferent programming environments, including REST APIs and RPC APIs. It is\nused by [gRPC](https://github.com/grpc). The error model is designed to be:\n\n- Simple to use and understand for most users\n- Flexible enough to meet unexpected needs\n\n# Overview\n\nThe `Status` message contains three pieces of data: error code, error\nmessage, and error details. The error code should be an enum value of\ngoogle.rpc.Code, but it may accept additional error codes if needed. The\nerror message should be a developer-facing English message that helps\ndevelopers *understand* and *resolve* the error. If a localized user-facing\nerror message is needed, put the localized message in the error details or\nlocalize it in the client. The optional error details may contain arbitrary\ninformation about the error. There is a predefined set of error detail types\nin the package `google.rpc` that can be used for common error conditions.\n\n# Language mapping\n\nThe `Status` message is the logical representation of the error model, but it\nis not necessarily the actual wire format. When the `Status` message is\nexposed in different client libraries and different wire protocols, it can be\nmapped differently. For example, it will likely be mapped to some exceptions\nin Java, but more likely mapped to some error codes in C.\n\n# Other uses\n\nThe error model and the `Status` message can be used in a variety of\nenvironments, either with or without APIs, to provide a\nconsistent developer experience across different environments.\n\nExample uses of this error model include:\n\n- Partial errors. If a service needs to return partial errors to the client,\n it may embed the `Status` in the normal response to indicate the partial\n errors.\n\n- Workflow errors. A typical workflow has multiple steps. Each step may\n have a `Status` message for error reporting.\n\n- Batch operations. If a client uses batch request and batch response, the\n `Status` message should be used directly inside batch response, one for\n each error sub-response.\n\n- Asynchronous operations. If an API call embeds asynchronous operation\n results in its response, the status of those operations should be\n represented directly using the `Status` message.\n\n- Logging. If some API errors are stored in logs, the message `Status` could\n be used directly after any stripping needed for security/privacy reasons.",
+ "description": "The `Status` type defines a logical error model that is suitable for\ndifferent programming environments, including REST APIs and RPC APIs. It is\nused by [gRPC](https://github.com/grpc). Each `Status` message contains\nthree pieces of data: error code, error message, and error details.\n\nYou can find out more about this error model and how to work with it in the\n[API Design Guide](https://cloud.google.com/apis/design/errors).",
"id": "Status",
"properties": {
"code": {
diff --git a/servicecontrol/v1/servicecontrol-gen.go b/servicecontrol/v1/servicecontrol-gen.go
index 853e2c2..9d6e3e3 100644
--- a/servicecontrol/v1/servicecontrol-gen.go
+++ b/servicecontrol/v1/servicecontrol-gen.go
@@ -2770,81 +2770,14 @@
// suitable for
// different programming environments, including REST APIs and RPC APIs.
// It is
-// used by [gRPC](https://github.com/grpc). The error model is designed
-// to be:
+// used by [gRPC](https://github.com/grpc). Each `Status` message
+// contains
+// three pieces of data: error code, error message, and error
+// details.
//
-// - Simple to use and understand for most users
-// - Flexible enough to meet unexpected needs
-//
-// # Overview
-//
-// The `Status` message contains three pieces of data: error code,
-// error
-// message, and error details. The error code should be an enum value
-// of
-// google.rpc.Code, but it may accept additional error codes if needed.
-// The
-// error message should be a developer-facing English message that
-// helps
-// developers *understand* and *resolve* the error. If a localized
-// user-facing
-// error message is needed, put the localized message in the error
-// details or
-// localize it in the client. The optional error details may contain
-// arbitrary
-// information about the error. There is a predefined set of error
-// detail types
-// in the package `google.rpc` that can be used for common error
-// conditions.
-//
-// # Language mapping
-//
-// The `Status` message is the logical representation of the error
-// model, but it
-// is not necessarily the actual wire format. When the `Status` message
-// is
-// exposed in different client libraries and different wire protocols,
-// it can be
-// mapped differently. For example, it will likely be mapped to some
-// exceptions
-// in Java, but more likely mapped to some error codes in C.
-//
-// # Other uses
-//
-// The error model and the `Status` message can be used in a variety
-// of
-// environments, either with or without APIs, to provide a
-// consistent developer experience across different
-// environments.
-//
-// Example uses of this error model include:
-//
-// - Partial errors. If a service needs to return partial errors to the
-// client,
-// it may embed the `Status` in the normal response to indicate the
-// partial
-// errors.
-//
-// - Workflow errors. A typical workflow has multiple steps. Each step
-// may
-// have a `Status` message for error reporting.
-//
-// - Batch operations. If a client uses batch request and batch
-// response, the
-// `Status` message should be used directly inside batch response,
-// one for
-// each error sub-response.
-//
-// - Asynchronous operations. If an API call embeds asynchronous
-// operation
-// results in its response, the status of those operations should
-// be
-// represented directly using the `Status` message.
-//
-// - Logging. If some API errors are stored in logs, the message
-// `Status` could
-// be used directly after any stripping needed for security/privacy
-// reasons.
+// 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 Status struct {
// Code: The status code, which should be an enum value of
// google.rpc.Code.
diff --git a/servicemanagement/v1/servicemanagement-api.json b/servicemanagement/v1/servicemanagement-api.json
index d3eb70e..2bb0d01 100644
--- a/servicemanagement/v1/servicemanagement-api.json
+++ b/servicemanagement/v1/servicemanagement-api.json
@@ -775,6 +775,11 @@
"serviceName"
],
"parameters": {
+ "baseRolloutId": {
+ "description": "Unimplemented. Do not use this feature until this comment is removed.\n\nThe rollout id that rollout to be created based on.\n\nRollout should be constructed based on current successful rollout, this\nfield indicates the current successful rollout id that new rollout based on\nto construct, if current successful rollout changed when server receives\nthe request, request will be rejected for safety.",
+ "location": "query",
+ "type": "string"
+ },
"serviceName": {
"description": "The name of the service. See the [overview](/service-management/overview)\nfor naming requirements. For example: `example.googleapis.com`.",
"location": "path",
@@ -876,7 +881,7 @@
}
}
},
- "revision": "20190510",
+ "revision": "20190610",
"rootUrl": "https://servicemanagement.googleapis.com/",
"schemas": {
"Advice": {
@@ -2299,7 +2304,7 @@
"type": "object"
},
"MonitoredResourceDescriptor": {
- "description": "An object that describes the schema of a MonitoredResource object using a\ntype name and a set of labels. For example, the monitored resource\ndescriptor for Google Compute Engine VM instances has a type of\n`\"gce_instance\"` and specifies the use of the labels `\"instance_id\"` and\n`\"zone\"` to identify particular VM instances.\n\nDifferent APIs can support different monitored resource types. APIs generally\nprovide a `list` method that returns the monitored resource descriptors used\nby the API.",
+ "description": "An object that describes the schema of a MonitoredResource object using a\ntype name and a set of labels. For example, the monitored resource\ndescriptor for Google Compute Engine VM instances has a type of\n`\"gce_instance\"` and specifies the use of the labels `\"instance_id\"` and\n`\"zone\"` to identify particular VM instances.\n\nDifferent APIs can support different monitored resource types. APIs generally\nprovide a `list` method that returns the monitored resource descriptors used\nby the API.\n\nNext ID: 10",
"id": "MonitoredResourceDescriptor",
"properties": {
"description": {
@@ -2851,7 +2856,7 @@
"type": "object"
},
"Status": {
- "description": "The `Status` type defines a logical error model that is suitable for\ndifferent programming environments, including REST APIs and RPC APIs. It is\nused by [gRPC](https://github.com/grpc). The error model is designed to be:\n\n- Simple to use and understand for most users\n- Flexible enough to meet unexpected needs\n\n# Overview\n\nThe `Status` message contains three pieces of data: error code, error\nmessage, and error details. The error code should be an enum value of\ngoogle.rpc.Code, but it may accept additional error codes if needed. The\nerror message should be a developer-facing English message that helps\ndevelopers *understand* and *resolve* the error. If a localized user-facing\nerror message is needed, put the localized message in the error details or\nlocalize it in the client. The optional error details may contain arbitrary\ninformation about the error. There is a predefined set of error detail types\nin the package `google.rpc` that can be used for common error conditions.\n\n# Language mapping\n\nThe `Status` message is the logical representation of the error model, but it\nis not necessarily the actual wire format. When the `Status` message is\nexposed in different client libraries and different wire protocols, it can be\nmapped differently. For example, it will likely be mapped to some exceptions\nin Java, but more likely mapped to some error codes in C.\n\n# Other uses\n\nThe error model and the `Status` message can be used in a variety of\nenvironments, either with or without APIs, to provide a\nconsistent developer experience across different environments.\n\nExample uses of this error model include:\n\n- Partial errors. If a service needs to return partial errors to the client,\n it may embed the `Status` in the normal response to indicate the partial\n errors.\n\n- Workflow errors. A typical workflow has multiple steps. Each step may\n have a `Status` message for error reporting.\n\n- Batch operations. If a client uses batch request and batch response, the\n `Status` message should be used directly inside batch response, one for\n each error sub-response.\n\n- Asynchronous operations. If an API call embeds asynchronous operation\n results in its response, the status of those operations should be\n represented directly using the `Status` message.\n\n- Logging. If some API errors are stored in logs, the message `Status` could\n be used directly after any stripping needed for security/privacy reasons.",
+ "description": "The `Status` type defines a logical error model that is suitable for\ndifferent programming environments, including REST APIs and RPC APIs. It is\nused by [gRPC](https://github.com/grpc). Each `Status` message contains\nthree pieces of data: error code, error message, and error details.\n\nYou can find out more about this error model and how to work with it in the\n[API Design Guide](https://cloud.google.com/apis/design/errors).",
"id": "Status",
"properties": {
"code": {
diff --git a/servicemanagement/v1/servicemanagement-gen.go b/servicemanagement/v1/servicemanagement-gen.go
index 25f4d8a..10d6ddc 100644
--- a/servicemanagement/v1/servicemanagement-gen.go
+++ b/servicemanagement/v1/servicemanagement-gen.go
@@ -3780,6 +3780,8 @@
// provide a `list` method that returns the monitored resource
// descriptors used
// by the API.
+//
+// Next ID: 10
type MonitoredResourceDescriptor struct {
// Description: Optional. A detailed description of the monitored
// resource type that might
@@ -5041,81 +5043,14 @@
// suitable for
// different programming environments, including REST APIs and RPC APIs.
// It is
-// used by [gRPC](https://github.com/grpc). The error model is designed
-// to be:
+// used by [gRPC](https://github.com/grpc). Each `Status` message
+// contains
+// three pieces of data: error code, error message, and error
+// details.
//
-// - Simple to use and understand for most users
-// - Flexible enough to meet unexpected needs
-//
-// # Overview
-//
-// The `Status` message contains three pieces of data: error code,
-// error
-// message, and error details. The error code should be an enum value
-// of
-// google.rpc.Code, but it may accept additional error codes if needed.
-// The
-// error message should be a developer-facing English message that
-// helps
-// developers *understand* and *resolve* the error. If a localized
-// user-facing
-// error message is needed, put the localized message in the error
-// details or
-// localize it in the client. The optional error details may contain
-// arbitrary
-// information about the error. There is a predefined set of error
-// detail types
-// in the package `google.rpc` that can be used for common error
-// conditions.
-//
-// # Language mapping
-//
-// The `Status` message is the logical representation of the error
-// model, but it
-// is not necessarily the actual wire format. When the `Status` message
-// is
-// exposed in different client libraries and different wire protocols,
-// it can be
-// mapped differently. For example, it will likely be mapped to some
-// exceptions
-// in Java, but more likely mapped to some error codes in C.
-//
-// # Other uses
-//
-// The error model and the `Status` message can be used in a variety
-// of
-// environments, either with or without APIs, to provide a
-// consistent developer experience across different
-// environments.
-//
-// Example uses of this error model include:
-//
-// - Partial errors. If a service needs to return partial errors to the
-// client,
-// it may embed the `Status` in the normal response to indicate the
-// partial
-// errors.
-//
-// - Workflow errors. A typical workflow has multiple steps. Each step
-// may
-// have a `Status` message for error reporting.
-//
-// - Batch operations. If a client uses batch request and batch
-// response, the
-// `Status` message should be used directly inside batch response,
-// one for
-// each error sub-response.
-//
-// - Asynchronous operations. If an API call embeds asynchronous
-// operation
-// results in its response, the status of those operations should
-// be
-// represented directly using the `Status` message.
-//
-// - Logging. If some API errors are stored in logs, the message
-// `Status` could
-// be used directly after any stripping needed for security/privacy
-// reasons.
+// 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 Status struct {
// Code: The status code, which should be an enum value of
// google.rpc.Code.
@@ -9114,6 +9049,24 @@
return c
}
+// BaseRolloutId sets the optional parameter "baseRolloutId":
+// Unimplemented. Do not use this feature until this comment is
+// removed.
+//
+// The rollout id that rollout to be created based on.
+//
+// Rollout should be constructed based on current successful rollout,
+// this
+// field indicates the current successful rollout id that new rollout
+// based on
+// to construct, if current successful rollout changed when server
+// receives
+// the request, request will be rejected for safety.
+func (c *ServicesRolloutsCreateCall) BaseRolloutId(baseRolloutId string) *ServicesRolloutsCreateCall {
+ c.urlParams_.Set("baseRolloutId", baseRolloutId)
+ return c
+}
+
// Fields allows partial responses to be retrieved. See
// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
// for more information.
@@ -9212,6 +9165,11 @@
// "serviceName"
// ],
// "parameters": {
+ // "baseRolloutId": {
+ // "description": "Unimplemented. Do not use this feature until this comment is removed.\n\nThe rollout id that rollout to be created based on.\n\nRollout should be constructed based on current successful rollout, this\nfield indicates the current successful rollout id that new rollout based on\nto construct, if current successful rollout changed when server receives\nthe request, request will be rejected for safety.",
+ // "location": "query",
+ // "type": "string"
+ // },
// "serviceName": {
// "description": "The name of the service. See the [overview](/service-management/overview)\nfor naming requirements. For example: `example.googleapis.com`.",
// "location": "path",
diff --git a/toolresults/v1beta3/toolresults-api.json b/toolresults/v1beta3/toolresults-api.json
index 7df67d2..12ad3e1 100644
--- a/toolresults/v1beta3/toolresults-api.json
+++ b/toolresults/v1beta3/toolresults-api.json
@@ -15,7 +15,7 @@
"description": "Reads and publishes results from Firebase Test Lab.",
"discoveryVersion": "v1",
"documentationLink": "https://firebase.google.com/docs/test-lab/",
- "etag": "\"VPK3KBfpaEgZ16pozGOoMYfKc0U/JTmZoC2nLuL_cjgyK29xhSrshLU\"",
+ "etag": "\"9eZ1uxVRThTDhLJCZHhqs3eQWz4/LfQ_G3efMP-O7BZIeolFCEKsFU4\"",
"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"
@@ -1271,7 +1271,7 @@
}
}
},
- "revision": "20190530",
+ "revision": "20190613",
"rootUrl": "https://www.googleapis.com/",
"schemas": {
"AndroidAppInfo": {
@@ -2456,6 +2456,7 @@
"enum": [
"error",
"failed",
+ "flaky",
"passed",
"skipped"
],
@@ -2463,6 +2464,7 @@
"",
"",
"",
+ "",
""
],
"type": "string"
diff --git a/toolresults/v1beta3/toolresults-gen.go b/toolresults/v1beta3/toolresults-gen.go
index 829a1b7..8adcf41 100644
--- a/toolresults/v1beta3/toolresults-gen.go
+++ b/toolresults/v1beta3/toolresults-gen.go
@@ -2619,6 +2619,7 @@
// Possible values:
// "error"
// "failed"
+ // "flaky"
// "passed"
// "skipped"
Status string `json:"status,omitempty"`
