TrueCloudLab/restic
16
0
Fork 3
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Update dependencies

Browse source
This commit is contained in:
Alexander Neumann 2017-09-13 14:09:48 +02:00
parent f3b49987f8
commit fda563d606
926 changed files with 189726 additions and 98666 deletions
Download patch file Download diff file Expand all files Collapse all files

535
vendor/google.golang.org/api/logging/v2beta1/logging-gen.go generated vendored
View file

@ -204,6 +204,55 @@ type ProjectsSinksService struct {
s *Service
}
// BucketOptions: BucketOptions describes the bucket boundaries used to
// create a histogram for the distribution. The buckets can be in a
// linear sequence, an exponential sequence, or each bucket can be
// specified explicitly. BucketOptions does not include the number of
// values in each bucket.A bucket has an inclusive lower bound and
// exclusive upper bound for the values that are counted for that
// bucket. The upper bound of a bucket must be strictly greater than the
// lower bound. The sequence of N buckets for a distribution consists of
// an underflow bucket (number 0), zero or more finite buckets (number 1
// through N - 2) and an overflow bucket (number N - 1). The buckets are
// contiguous: the lower bound of bucket i (i > 0) is the same as the
// upper bound of bucket i - 1. The buckets span the whole range of
// finite values: lower bound of the underflow bucket is -infinity and
// the upper bound of the overflow bucket is +infinity. The finite
// buckets are so-called because both bounds are finite.
type BucketOptions struct {
// ExplicitBuckets: The explicit buckets.
ExplicitBuckets *Explicit `json:"explicitBuckets,omitempty"`
// ExponentialBuckets: The exponential buckets.
ExponentialBuckets *Exponential `json:"exponentialBuckets,omitempty"`
// LinearBuckets: The linear bucket.
LinearBuckets *Linear `json:"linearBuckets,omitempty"`
// ForceSendFields is a list of field names (e.g. "ExplicitBuckets") 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. "ExplicitBuckets") 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 *BucketOptions) MarshalJSON() ([]byte, error) {
type noMethod BucketOptions
raw := noMethod(*s)
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
// Empty: A generic empty message that you can re-use to avoid defining
// duplicated empty messages in your APIs. A typical example is to use
// it as the request or the response type of an API method. For
@ -219,6 +268,96 @@ type Empty struct {
googleapi.ServerResponse `json:"-"`
}
// Explicit: Specifies a set of buckets with arbitrary widths.There are
// size(bounds) + 1 (= N) buckets. Bucket i has the following
// boundaries:Upper bound (0 <= i < N-1): boundsi Lower bound (1 <= i <
// N); boundsi - 1The bounds field must contain at least one element. If
// bounds has only one element, then there are no finite buckets, and
// that single element is the common boundary of the overflow and
// underflow buckets.
type Explicit struct {
// Bounds: The values must be monotonically increasing.
Bounds []float64 `json:"bounds,omitempty"`
// ForceSendFields is a list of field names (e.g. "Bounds") 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. "Bounds") 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 *Explicit) MarshalJSON() ([]byte, error) {
type noMethod Explicit
raw := noMethod(*s)
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
// Exponential: Specifies an exponential sequence of buckets that have a
// width that is proportional to the value of the lower bound. Each
// bucket represents a constant relative uncertainty on a specific value
// in the bucket.There are num_finite_buckets + 2 (= N) buckets. Bucket
// i has the following boundaries:Upper bound (0 <= i < N-1): scale *
// (growth_factor ^ i). Lower bound (1 <= i < N): scale *
// (growth_factor ^ (i - 1)).
type Exponential struct {
// GrowthFactor: Must be greater than 1.
GrowthFactor float64 `json:"growthFactor,omitempty"`
// NumFiniteBuckets: Must be greater than 0.
NumFiniteBuckets int64 `json:"numFiniteBuckets,omitempty"`
// Scale: Must be greater than 0.
Scale float64 `json:"scale,omitempty"`
// ForceSendFields is a list of field names (e.g. "GrowthFactor") 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. "GrowthFactor") 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 *Exponential) MarshalJSON() ([]byte, error) {
type noMethod Exponential
raw := noMethod(*s)
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
func (s *Exponential) UnmarshalJSON(data []byte) error {
type noMethod Exponential
var s1 struct {
GrowthFactor gensupport.JSONFloat64 `json:"growthFactor"`
Scale gensupport.JSONFloat64 `json:"scale"`
*noMethod
}
s1.noMethod = (*noMethod)(s)
if err := json.Unmarshal(data, &s1); err != nil {
return err
}
s.GrowthFactor = float64(s1.GrowthFactor)
s.Scale = float64(s1.Scale)
return nil
}
// HttpRequest: A common proto for logging HTTP requests. Only contains
// semantics defined by the HTTP specification. Product-specific logging
// information MUST be defined in a separate message.
@ -243,6 +382,10 @@ type HttpRequest struct {
// the request was received until the response was sent.
Latency string `json:"latency,omitempty"`
// Protocol: Protocol used for the request. Examples: "HTTP/1.1",
// "HTTP/2", "websocket"
Protocol string `json:"protocol,omitempty"`
// Referer: The referer URL of the request, as defined in HTTP/1.1
// Header Field Definitions
// (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
@ -345,6 +488,62 @@ func (s *LabelDescriptor) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
// Linear: Specifies a linear sequence of buckets that all have the same
// width (except overflow and underflow). Each bucket represents a
// constant absolute uncertainty on the specific value in the
// bucket.There are num_finite_buckets + 2 (= N) buckets. Bucket i has
// the following boundaries:Upper bound (0 <= i < N-1): offset + (width
// * i). Lower bound (1 <= i < N): offset + (width * (i - 1)).
type Linear struct {
// NumFiniteBuckets: Must be greater than 0.
NumFiniteBuckets int64 `json:"numFiniteBuckets,omitempty"`
// Offset: Lower bound of the first bucket.
Offset float64 `json:"offset,omitempty"`
// Width: Must be greater than 0.
Width float64 `json:"width,omitempty"`
// ForceSendFields is a list of field names (e.g. "NumFiniteBuckets") 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. "NumFiniteBuckets") 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 *Linear) MarshalJSON() ([]byte, error) {
type noMethod Linear
raw := noMethod(*s)
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
func (s *Linear) UnmarshalJSON(data []byte) error {
type noMethod Linear
var s1 struct {
Offset gensupport.JSONFloat64 `json:"offset"`
Width gensupport.JSONFloat64 `json:"width"`
*noMethod
}
s1.noMethod = (*noMethod)(s)
if err := json.Unmarshal(data, &s1); err != nil {
return err
}
s.Offset = float64(s1.Offset)
s.Width = float64(s1.Width)
return nil
}
// ListLogEntriesRequest: The parameters to ListLogEntries.
type ListLogEntriesRequest struct {
// Filter: Optional. A filter that chooses which log entries to return.
@ -420,7 +619,9 @@ func (s *ListLogEntriesRequest) MarshalJSON() ([]byte, error) {
// ListLogEntriesResponse: Result returned from ListLogEntries.
type ListLogEntriesResponse struct {
// Entries: A list of log entries.
// Entries: A list of log entries. If entries is empty, nextPageToken
// may still be returned, indicating that more entries may exist. See
// nextPageToken for more information.
Entries []*LogEntry `json:"entries,omitempty"`
// NextPageToken: If there might be more results than those appearing in
@ -627,9 +828,9 @@ type LogEntry struct {
// provide a value, then Stackdriver Logging considers other log entries
// in the same project, with the same timestamp, and with the same
// insert_id to be duplicates which can be removed. If omitted in new
// log entries, then Stackdriver Logging will insert its own unique
// identifier. The insert_id is used to order log entries that have the
// same timestamp value.
// log entries, then Stackdriver Logging assigns its own unique
// identifier. The insert_id is also used to order log entries that have
// the same timestamp value.
InsertId string `json:"insertId,omitempty"`
// JsonPayload: The log entry payload, represented as a structure that
@ -707,10 +908,12 @@ type LogEntry struct {
TextPayload string `json:"textPayload,omitempty"`
// Timestamp: Optional. The time the event described by the log entry
// occurred. If omitted in a new log entry, Stackdriver Logging will
// insert the time the log entry is received. Stackdriver Logging might
// reject log entries whose time stamps are more than a couple of hours
// in the future. Log entries with time stamps in the past are accepted.
// occurred. This time is used to compute the log entry's age and to
// enforce the logs retention period. If this field is omitted in a new
// log entry, then Stackdriver Logging assigns it the current
// time.Incoming log entries should have timestamps that are no more
// than the logs retention period in the past, and no more than 24 hours
// in the future. See the entries.write API method for more information.
Timestamp string `json:"timestamp,omitempty"`
// Trace: Optional. Resource name of the trace associated with the log
@ -881,8 +1084,17 @@ func (s *LogLine) MarshalJSON() ([]byte, error) {
// LogMetric: Describes a logs-based metric. The value of the metric is
// the number of log entries that match a logs filter in a given time
// interval.
// interval.Logs-based metric can also be used to extract values from
// logs and create a a distribution of the values. The distribution
// records the statistics of the extracted values along with an optional
// histogram of the values as specified by the bucket options.
type LogMetric struct {
// BucketOptions: Optional. The bucket_options are required when the
// logs-based metric is using a DISTRIBUTION value type and it describes
// the bucket boundaries used to create a histogram of the extracted
// values.
BucketOptions *BucketOptions `json:"bucketOptions,omitempty"`
// Description: Optional. A description of this metric, which is used in
// documentation.
Description string `json:"description,omitempty"`
@ -893,6 +1105,38 @@ type LogMetric struct {
// The maximum length of the filter is 20000 characters.
Filter string `json:"filter,omitempty"`
// LabelExtractors: Optional. A map from a label key string to an
// extractor expression which is used to extract data from a log entry
// field and assign as the label value. Each label key specified in the
// LabelDescriptor must have an associated extractor expression in this
// map. The syntax of the extractor expression is the same as for the
// value_extractor field.The extracted value is converted to the type
// defined in the label descriptor. If the either the extraction or the
// type conversion fails, the label will have a default value. The
// default value for a string label is an empty string, for an integer
// label its 0, and for a boolean label its false.Note that there are
// upper bounds on the maximum number of labels and the number of active
// time series that are allowed in a project.
LabelExtractors map[string]string `json:"labelExtractors,omitempty"`
// MetricDescriptor: Optional. The metric descriptor associated with the
// logs-based metric. If unspecified, it uses a default metric
// descriptor with a DELTA metric kind, INT64 value type, with no labels
// and a unit of "1". Such a metric counts the number of log entries
// matching the filter expression.The name, type, and description fields
// in the metric_descriptor are output only, and is constructed using
// the name and description field in the LogMetric.To create a
// logs-based metric that records a distribution of log values, a DELTA
// metric kind with a DISTRIBUTION value type must be used along with a
// value_extractor expression in the LogMetric.Each label in the metric
// descriptor must have a matching label name as the key and an
// extractor expression as the value in the label_extractors map.The
// metric_kind and value_type fields in the metric_descriptor cannot be
// updated once initially configured. New labels can be added in the
// metric_descriptor, but existing labels cannot be modified except for
// their description.
MetricDescriptor *MetricDescriptor `json:"metricDescriptor,omitempty"`
// Name: Required. The client-assigned metric identifier. Examples:
// "error_count", "nginx/requests".Metric identifiers are limited to 100
// characters and can include only the following characters: A-Z, a-z,
@ -906,10 +1150,26 @@ type LogMetric struct {
// Example: "projects/my-project/metrics/nginx%2Frequests".
Name string `json:"name,omitempty"`
// Version: Output only. The API version that created or updated this
// metric. The version also dictates the syntax of the filter
// expression. When a value for this field is missing, the default value
// of V2 should be assumed.
// ValueExtractor: Optional. A value_extractor is required when using a
// distribution logs-based metric to extract the values to record from a
// log entry. Two functions are supported for value extraction:
// EXTRACT(field) or REGEXP_EXTRACT(field, regex). The argument are: 1.
// field: The name of the log entry field from which the value is to be
// extracted. 2. regex: A regular expression using the Google RE2
// syntax (https://github.com/google/re2/wiki/Syntax) with a single
// capture group to extract data from the specified log entry field.
// The value of the field is converted to a string before applying the
// regex. It is an error to specify a regex that does not include
// exactly one capture group.The result of the extraction must be
// convertible to a double type, as the distribution always records
// double values. If either the extraction or the conversion to double
// fails, then those values are not recorded in the
// distribution.Example: REGEXP_EXTRACT(jsonPayload.request,
// ".*quantity=(\d+).*")
ValueExtractor string `json:"valueExtractor,omitempty"`
// Version: Deprecated. The API version that created or updated this
// metric. The v2 format is used by default and cannot be changed.
//
// Possible values:
// "V2" - Stackdriver Logging API v2.
@ -920,7 +1180,7 @@ type LogMetric struct {
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Description") to
// ForceSendFields is a list of field names (e.g. "BucketOptions") 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
@ -928,7 +1188,7 @@ type LogMetric struct {
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Description") to include
// NullFields is a list of field names (e.g. "BucketOptions") 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
@ -961,18 +1221,14 @@ type LogSink struct {
// not exported. For more information, see Exporting Logs With Sinks.
Destination string `json:"destination,omitempty"`
// EndTime: Optional. The time at which this sink will stop exporting
// log entries. Log entries are exported only if their timestamp is
// earlier than the end time. If this field is not supplied, there is no
// end time. If both a start time and an end time are provided, then the
// end time must be later than the start time.
// EndTime: Deprecated. This field is ignored when creating or updating
// sinks.
EndTime string `json:"endTime,omitempty"`
// Filter: Optional. An advanced logs filter. The only exported log
// entries are those that are in the resource owning the sink and that
// match the filter. The filter must use the log entry format specified
// by the output_version_format parameter. For example, in the v2
// format:
// match the filter. For
// example:
// logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
//
Filter string `json:"filter,omitempty"`
@ -1013,10 +1269,8 @@ type LogSink struct {
// "V1" - LogEntry version 1 format.
OutputVersionFormat string `json:"outputVersionFormat,omitempty"`
// StartTime: Optional. The time at which this sink will begin exporting
// log entries. Log entries are exported only if their timestamp is not
// earlier than the start time. The default value of this field is the
// time the sink is created or updated.
// StartTime: Deprecated. This field is ignored when creating or
// updating sinks.
StartTime string `json:"startTime,omitempty"`
// WriterIdentity: Output only. An IAM identity&mdash;a service account
@ -1057,6 +1311,154 @@ func (s *LogSink) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
// MetricDescriptor: Defines a metric type and its schema. Once a metric
// descriptor is created, deleting or altering it stops data collection
// and makes the metric type's existing data unusable.
type MetricDescriptor struct {
// Description: A detailed description of the metric, which can be used
// in documentation.
Description string `json:"description,omitempty"`
// DisplayName: A concise name for the metric, which can be displayed in
// user interfaces. Use sentence case without an ending period, for
// example "Request count".
DisplayName string `json:"displayName,omitempty"`
// Labels: The set of labels that can be used to describe a specific
// instance of this metric type. For example, the
// appengine.googleapis.com/http/server/response_latencies metric type
// has a label for the HTTP response code, response_code, so you can
// look at latencies for successful responses or just for responses that
// failed.
Labels []*LabelDescriptor `json:"labels,omitempty"`
// MetricKind: Whether the metric records instantaneous values, changes
// to a value, etc. Some combinations of metric_kind and value_type
// might not be supported.
//
// Possible values:
// "METRIC_KIND_UNSPECIFIED" - Do not use this default value.
// "GAUGE" - An instantaneous measurement of a value.
// "DELTA" - The change in a value during a time interval.
// "CUMULATIVE" - A value accumulated over a time interval. Cumulative
// measurements in a time series should have the same start time and
// increasing end times, until an event resets the cumulative value to
// zero and sets a new start time for the following points.
MetricKind string `json:"metricKind,omitempty"`
// Name: The resource name of the metric descriptor. Depending on the
// implementation, the name typically includes: (1) the parent resource
// name that defines the scope of the metric type or of its data; and
// (2) the metric's URL-encoded type, which also appears in the type
// field of this descriptor. For example, following is the resource name
// of a custom metric within the GCP project
// my-project-id:
// "projects/my-project-id/metricDescriptors/custom.google
// apis.com%2Finvoice%2Fpaid%2Famount"
//
Name string `json:"name,omitempty"`
// Type: The metric type, including its DNS name prefix. The type is not
// URL-encoded. All user-defined custom metric types have the DNS name
// custom.googleapis.com. Metric types should use a natural hierarchical
// grouping. For
// example:
// "custom.googleapis.com/invoice/paid/amount"
// "appengine.google
// apis.com/http/server/response_latencies"
//
Type string `json:"type,omitempty"`
// Unit: The unit in which the metric value is reported. It is only
// applicable if the value_type is INT64, DOUBLE, or DISTRIBUTION. The
// supported units are a subset of The Unified Code for Units of Measure
// (http://unitsofmeasure.org/ucum.html) standard:Basic units (UNIT)
// bit bit
// By byte
// s second
// min minute
// h hour
// d dayPrefixes (PREFIX)
// k kilo (10**3)
// M mega (10**6)
// G giga (10**9)
// T tera (10**12)
// P peta (10**15)
// E exa (10**18)
// Z zetta (10**21)
// Y yotta (10**24)
// m milli (10**-3)
// u micro (10**-6)
// n nano (10**-9)
// p pico (10**-12)
// f femto (10**-15)
// a atto (10**-18)
// z zepto (10**-21)
// y yocto (10**-24)
// Ki kibi (2**10)
// Mi mebi (2**20)
// Gi gibi (2**30)
// Ti tebi (2**40)GrammarThe grammar includes the dimensionless unit 1,
// such as 1/s.The grammar also includes these connectors:
// / division (as an infix operator, e.g. 1/s).
// . multiplication (as an infix operator, e.g. GBy.d)The grammar for a
// unit is as follows:
// Expression = Component { "." Component } { "/" Component }
// ;
//
// Component = [ PREFIX ] UNIT [ Annotation ]
// | Annotation
// | "1"
// ;
//
// Annotation = "{" NAME "}" ;
// Notes:
// Annotation is just a comment if it follows a UNIT and is equivalent
// to 1 if it is used alone. For examples, {requests}/s == 1/s,
// By{transmitted}/s == By/s.
// NAME is a sequence of non-blank printable ASCII characters not
// containing '{' or '}'.
Unit string `json:"unit,omitempty"`
// ValueType: Whether the measurement is an integer, a floating-point
// number, etc. Some combinations of metric_kind and value_type might
// not be supported.
//
// Possible values:
// "VALUE_TYPE_UNSPECIFIED" - Do not use this default value.
// "BOOL" - The value is a boolean. This value type can be used only
// if the metric kind is GAUGE.
// "INT64" - The value is a signed 64-bit integer.
// "DOUBLE" - The value is a double precision floating point number.
// "STRING" - The value is a text string. This value type can be used
// only if the metric kind is GAUGE.
// "DISTRIBUTION" - The value is a Distribution.
// "MONEY" - The value is money.
ValueType string `json:"valueType,omitempty"`
// ForceSendFields is a list of field names (e.g. "Description") 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. "Description") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}
func (s *MetricDescriptor) MarshalJSON() ([]byte, error) {
type noMethod MetricDescriptor
raw := noMethod(*s)
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
// MonitoredResource: An object representing a resource that can be used
// for monitoring, logging, billing, or other purposes. Examples include
// virtual machine instances, databases, and storage devices such as
@ -1404,17 +1806,23 @@ func (s *SourceReference) MarshalJSON() ([]byte, error) {
// WriteLogEntriesRequest: The parameters to WriteLogEntries.
type WriteLogEntriesRequest struct {
// Entries: Required. The log entries to write. Values supplied for the
// fields log_name, resource, and labels in this entries.write request
// are inserted into those log entries in this list that do not provide
// their own values.Stackdriver Logging also creates and inserts values
// for timestamp and insert_id if the entries do not provide them. The
// created insert_id for the N'th entry in this list will be greater
// than earlier entries and less than later entries. Otherwise, the
// order of log entries in this list does not matter.To improve
// throughput and to avoid exceeding the quota limit for calls to
// entries.write, you should write multiple log entries at once rather
// than calling this method for each individual log entry.
// Entries: Required. The log entries to send to Stackdriver Logging.
// The order of log entries in this list does not matter. Values
// supplied in this method's log_name, resource, and labels fields are
// copied into those log entries in this list that do not include values
// for their corresponding fields. For more information, see the
// LogEntry type.If the timestamp or insert_id fields are missing in log
// entries, then this method supplies the current time or a unique
// identifier, respectively. The supplied values are chosen so that,
// among the log entries that did not supply their own values, the
// entries earlier in the list will sort before the entries later in the
// list. See the entries.list method.Log entries with timestamps that
// are more than the logs retention period in the past or more than 24
// hours in the future might be discarded. Discarding does not return an
// error.To improve throughput and to avoid exceeding the quota limit
// for calls to entries.write, you should try to include several log
// entries in this list, rather than calling this method for each
// individual log entry.
Entries []*LogEntry `json:"entries,omitempty"`
// Labels: Optional. Default labels that are added to the labels field
@ -1964,7 +2372,11 @@ type EntriesWriteCall struct {
header_ http.Header
}
// Write: Writes log entries to Stackdriver Logging.
// Write: Log entry resourcesWrites log entries to Stackdriver Logging.
// This API method is the only way to send log entries to Stackdriver
// Logging. This method is used, directly or indirectly, by the
// Stackdriver Logging agent (fluentd) and all logging libraries
// configured to use Stackdriver Logging.
func (r *EntriesService) Write(writelogentriesrequest *WriteLogEntriesRequest) *EntriesWriteCall {
c := &EntriesWriteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.writelogentriesrequest = writelogentriesrequest
@ -2054,7 +2466,7 @@ func (c *EntriesWriteCall) Do(opts ...googleapi.CallOption) (*WriteLogEntriesRes
}
return ret, nil
// {
// "description": "Writes log entries to Stackdriver Logging.",
// "description": "Log entry resourcesWrites log entries to Stackdriver Logging. This API method is the only way to send log entries to Stackdriver Logging. This method is used, directly or indirectly, by the Stackdriver Logging agent (fluentd) and all logging libraries configured to use Stackdriver Logging.",
// "flatPath": "v2beta1/entries:write",
// "httpMethod": "POST",
// "id": "logging.entries.write",
@ -3651,10 +4063,9 @@ type ProjectsSinksCreateCall struct {
// Create: Creates a sink that exports specified log entries to a
// destination. The export of newly-ingested log entries begins
// immediately, unless the current time is outside the sink's start and
// end times or the sink's writer_identity is not permitted to write to
// the destination. A sink can export log entries only from the resource
// owning the sink.
// immediately, unless the sink's writer_identity is not permitted to
// write to the destination. A sink can export log entries only from the
// resource owning the sink.
func (r *ProjectsSinksService) Create(parent string, logsink *LogSink) *ProjectsSinksCreateCall {
c := &ProjectsSinksCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@ -3765,7 +4176,7 @@ func (c *ProjectsSinksCreateCall) Do(opts ...googleapi.CallOption) (*LogSink, er
}
return ret, nil
// {
// "description": "Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the current time is outside the sink's start and end times or the sink's writer_identity is not permitted to write to the destination. A sink can export log entries only from the resource owning the sink.",
// "description": "Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the sink's writer_identity is not permitted to write to the destination. A sink can export log entries only from the resource owning the sink.",
// "flatPath": "v2beta1/projects/{projectsId}/sinks",
// "httpMethod": "POST",
// "id": "logging.projects.sinks.create",
@ -4274,13 +4685,10 @@ type ProjectsSinksUpdateCall struct {
header_ http.Header
}
// Update: Updates a sink. If the named sink doesn't exist, then this
// method is identical to sinks.create. If the named sink does exist,
// then this method replaces the following fields in the existing sink
// with values from the new sink: destination, filter,
// output_version_format, start_time, and end_time. The updated filter
// might also have a new writer_identity; see the unique_writer_identity
// field.
// Update: Updates a sink. This method replaces the following fields in
// the existing sink with values from the new sink: destination, and
// filter. The updated sink might also have a new writer_identity; see
// the unique_writer_identity field.
func (r *ProjectsSinksService) Update(sinkNameid string, logsink *LogSink) *ProjectsSinksUpdateCall {
c := &ProjectsSinksUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.sinkNameid = sinkNameid
@ -4304,6 +4712,21 @@ func (c *ProjectsSinksUpdateCall) UniqueWriterIdentity(uniqueWriterIdentity bool
return c
}
// UpdateMask sets the optional parameter "updateMask": Field mask that
// specifies the fields in sink that need an update. A sink field will
// be overwritten if, and only if, it is in the update mask. name and
// output only fields cannot be updated.An empty updateMask is
// temporarily treated as using the following mask for backwards
// compatibility purposes: destination,filter,includeChildren At some
// point in the future, behavior will be removed and specifying an empty
// updateMask will be an error.For a detailed FieldMask definition, see
// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmaskExample:
// updateMask=filter.
func (c *ProjectsSinksUpdateCall) UpdateMask(updateMask string) *ProjectsSinksUpdateCall {
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.
@ -4390,7 +4813,7 @@ func (c *ProjectsSinksUpdateCall) Do(opts ...googleapi.CallOption) (*LogSink, er
}
return ret, nil
// {
// "description": "Updates a sink. If the named sink doesn't exist, then this method is identical to sinks.create. If the named sink does exist, then this method replaces the following fields in the existing sink with values from the new sink: destination, filter, output_version_format, start_time, and end_time. The updated filter might also have a new writer_identity; see the unique_writer_identity field.",
// "description": "Updates a sink. This method replaces the following fields in the existing sink with values from the new sink: destination, and filter. The updated sink might also have a new writer_identity; see the unique_writer_identity field.",
// "flatPath": "v2beta1/projects/{projectsId}/sinks/{sinksId}",
// "httpMethod": "PUT",
// "id": "logging.projects.sinks.update",
@ -4409,6 +4832,12 @@ func (c *ProjectsSinksUpdateCall) Do(opts ...googleapi.CallOption) (*LogSink, er
// "description": "Optional. See sinks.create for a description of this field. When updating a sink, the effect of this field on the value of writer_identity in the updated sink depends on both the old and new values of this field:\nIf the old and new values of this field are both false or both true, then there is no change to the sink's writer_identity.\nIf the old value is false and the new value is true, then writer_identity is changed to a unique service account.\nIt is an error if the old value is true and the new value is set to false or defaulted to false.",
// "location": "query",
// "type": "boolean"
// },
// "updateMask": {
// "description": "Optional. Field mask that specifies the fields in sink that need an update. A sink field will be overwritten if, and only if, it is in the update mask. name and output only fields cannot be updated.An empty updateMask is temporarily treated as using the following mask for backwards compatibility purposes: destination,filter,includeChildren At some point in the future, behavior will be removed and specifying an empty updateMask will be an error.For a detailed FieldMask definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmaskExample: updateMask=filter.",
// "format": "google-fieldmask",
// "location": "query",
// "type": "string"
// }
// },
// "path": "v2beta1/{+sinkName}",