docs: update generated docs (#981)
diff --git a/docs/dyn/servicecontrol_v1.services.html b/docs/dyn/servicecontrol_v1.services.html
index ca06b23..3356454 100644
--- a/docs/dyn/servicecontrol_v1.services.html
+++ b/docs/dyn/servicecontrol_v1.services.html
@@ -107,19 +107,14 @@
The object takes the form of:
{ # Request message for the AllocateQuota method.
- "serviceConfigId": "A String", # Specifies which version of service configuration should be used to process
- # the request. If unspecified or no matching version can be found, the latest
- # one will be used.
"allocateOperation": { # Represents information regarding a quota operation. # Operation that describes the quota allocation.
- "labels": { # Labels describing the operation.
- "a_key": "A String",
- },
"consumerId": "A String", # Identity of the consumer for whom this quota operation is being performed.
#
# This can be in one of the following formats:
# project:<project_id>,
# project_number:<project_number>,
# api_key:<api_key>.
+ "quotaMode": "A String", # Quota mode for this operation.
"operationId": "A String", # Identity of the operation. This is expected to be unique within the scope
# of the service that generated the operation, and guarantees idempotency in
# case of retries.
@@ -139,7 +134,9 @@
#
# Example of an RPC method name:
# google.example.library.v1.LibraryService.CreateShelf
- "quotaMode": "A String", # Quota mode for this operation.
+ "labels": { # Labels describing the operation.
+ "a_key": "A String",
+ },
"quotaMetrics": [ # Represents information about this operation. Each MetricValueSet
# corresponds to a metric defined in the service configuration.
# The data type used in the MetricValueSet must agree with
@@ -155,33 +152,12 @@
{ # Represents a set of metric values in the same metric.
# Each metric value in the set should have a unique combination of start time,
# end time, and label values.
- "metricName": "A String", # The metric name defined in the service configuration.
"metricValues": [ # The values in this metric.
{ # Represents a single metric value.
"startTime": "A String", # The start of the time period over which this metric value's measurement
# applies. The time period has different semantics for different metric
# types (cumulative, delta, and gauge). See the metric definition
# documentation in the service configuration for details.
- "moneyValue": { # Represents an amount of money with its currency type. # A money value.
- "nanos": 42, # Number of nano (10^-9) units of the amount.
- # The value must be between -999,999,999 and +999,999,999 inclusive.
- # If `units` is positive, `nanos` must be positive or zero.
- # If `units` is zero, `nanos` can be positive, zero, or negative.
- # If `units` is negative, `nanos` must be negative or zero.
- # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
- "units": "A String", # The whole units of the amount.
- # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- },
- "labels": { # The labels describing the metric value.
- # See comments on google.api.servicecontrol.v1.Operation.labels for
- # the overriding relationship.
- # Note that this map must not contain monitored resource labels.
- "a_key": "A String",
- },
- "stringValue": "A String", # A text string value.
- "doubleValue": 3.14, # A double precision floating point value.
- "int64Value": "A String", # A signed 64-bit integer value.
"distributionValue": { # Distribution represents a frequency distribution of double-valued sample # A distribution value.
# points. It contains the size of the population of sample points plus
# additional optional information:
@@ -190,10 +166,51 @@
# - the minimum and maximum of the samples
# - the sum-squared-deviation of the samples, used to compute variance
# - a histogram of the values of the sample points
+ "bucketCounts": [ # The number of samples in each histogram bucket. `bucket_counts` are
+ # optional. If present, they must sum to the `count` value.
+ #
+ # The buckets are defined below in `bucket_option`. There are N buckets.
+ # `bucket_counts[0]` is the number of samples in the underflow bucket.
+ # `bucket_counts[1]` to `bucket_counts[N-1]` are the numbers of samples
+ # in each of the finite buckets. And `bucket_counts[N] is the number
+ # of samples in the overflow bucket. See the comments of `bucket_option`
+ # below for more details.
+ #
+ # Any suffix of trailing zeros may be omitted.
+ "A String",
+ ],
+ "count": "A String", # The total number of samples in the distribution. Must be >= 0.
"sumOfSquaredDeviation": 3.14, # The sum of squared deviations from the mean:
# Sum[i=1..count]((x_i - mean)^2)
# where each x_i is a sample values. If `count` is zero then this field
# must be zero, otherwise validation of the request fails.
+ "linearBuckets": { # Describing buckets with constant width. # Buckets with constant width.
+ "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
+ # the total number of buckets is `num_finite_buckets` + 2.
+ # See comments on `bucket_options` for details.
+ "offset": 3.14, # The i'th linear bucket covers the interval
+ # [offset + (i-1) * width, offset + i * width)
+ # where i ranges from 1 to num_finite_buckets, inclusive.
+ "width": 3.14, # The i'th linear bucket covers the interval
+ # [offset + (i-1) * width, offset + i * width)
+ # where i ranges from 1 to num_finite_buckets, inclusive.
+ # Must be strictly positive.
+ },
+ "maximum": 3.14, # The maximum of the population of values. Ignored if `count` is zero.
+ "exponentialBuckets": { # Describing buckets with exponentially growing width. # Buckets with exponentially growing width.
+ "growthFactor": 3.14, # The i'th exponential bucket covers the interval
+ # [scale * growth_factor^(i-1), scale * growth_factor^i)
+ # where i ranges from 1 to num_finite_buckets inclusive.
+ # Must be larger than 1.0.
+ "scale": 3.14, # The i'th exponential bucket covers the interval
+ # [scale * growth_factor^(i-1), scale * growth_factor^i)
+ # where i ranges from 1 to num_finite_buckets inclusive.
+ # Must be > 0.
+ "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
+ # the total number of buckets is `num_finite_buckets` + 2.
+ # See comments on `bucket_options` for details.
+ },
+ "minimum": 3.14, # The minimum of the population of values. Ignored if `count` is zero.
"exemplars": [ # Example points. Must be in increasing order of `value` field.
{ # Exemplars are example points that may be used to annotate aggregated
# distribution values. They are metadata that gives information about a
@@ -202,7 +219,6 @@
# such as a example values and timestamps, origin, etc.
"value": 3.14, # Value of the exemplar point. This value determines to which bucket the
# exemplar belongs.
- "timestamp": "A String", # The observation (sampling) time of the above value.
"attachments": [ # Contextual information about the example value. Examples are:
#
# Trace: type.googleapis.com/google.monitoring.v3.SpanContext
@@ -218,50 +234,11 @@
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
+ "timestamp": "A String", # The observation (sampling) time of the above value.
},
],
- "exponentialBuckets": { # Describing buckets with exponentially growing width. # Buckets with exponentially growing width.
- "growthFactor": 3.14, # The i'th exponential bucket covers the interval
- # [scale * growth_factor^(i-1), scale * growth_factor^i)
- # where i ranges from 1 to num_finite_buckets inclusive.
- # Must be larger than 1.0.
- "scale": 3.14, # The i'th exponential bucket covers the interval
- # [scale * growth_factor^(i-1), scale * growth_factor^i)
- # where i ranges from 1 to num_finite_buckets inclusive.
- # Must be > 0.
- "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
- # the total number of buckets is `num_finite_buckets` + 2.
- # See comments on `bucket_options` for details.
- },
- "minimum": 3.14, # The minimum of the population of values. Ignored if `count` is zero.
- "linearBuckets": { # Describing buckets with constant width. # Buckets with constant width.
- "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
- # the total number of buckets is `num_finite_buckets` + 2.
- # See comments on `bucket_options` for details.
- "width": 3.14, # The i'th linear bucket covers the interval
- # [offset + (i-1) * width, offset + i * width)
- # where i ranges from 1 to num_finite_buckets, inclusive.
- # Must be strictly positive.
- "offset": 3.14, # The i'th linear bucket covers the interval
- # [offset + (i-1) * width, offset + i * width)
- # where i ranges from 1 to num_finite_buckets, inclusive.
- },
"mean": 3.14, # The arithmetic mean of the samples in the distribution. If `count` is
# zero then this field must be zero.
- "count": "A String", # The total number of samples in the distribution. Must be >= 0.
- "bucketCounts": [ # The number of samples in each histogram bucket. `bucket_counts` are
- # optional. If present, they must sum to the `count` value.
- #
- # The buckets are defined below in `bucket_option`. There are N buckets.
- # `bucket_counts[0]` is the number of samples in the underflow bucket.
- # `bucket_counts[1]` to `bucket_counts[N-1]` are the numbers of samples
- # in each of the finite buckets. And `bucket_counts[N] is the number
- # of samples in the overflow bucket. See the comments of `bucket_option`
- # below for more details.
- #
- # Any suffix of trailing zeros may be omitted.
- "A String",
- ],
"explicitBuckets": { # Describing buckets with arbitrary user-provided width. # Buckets with arbitrary user-provided width.
"bounds": [ # 'bound' is a list of strictly increasing boundaries between
# buckets. Note that a list of length N-1 defines N buckets because
@@ -281,16 +258,39 @@
3.14,
],
},
- "maximum": 3.14, # The maximum of the population of values. Ignored if `count` is zero.
},
- "boolValue": True or False, # A boolean value.
+ "labels": { # The labels describing the metric value.
+ # See comments on google.api.servicecontrol.v1.Operation.labels for
+ # the overriding relationship.
+ # Note that this map must not contain monitored resource labels.
+ "a_key": "A String",
+ },
+ "doubleValue": 3.14, # A double precision floating point value.
"endTime": "A String", # The end of the time period over which this metric value's measurement
# applies.
+ "boolValue": True or False, # A boolean value.
+ "int64Value": "A String", # A signed 64-bit integer value.
+ "moneyValue": { # Represents an amount of money with its currency type. # A money value.
+ "nanos": 42, # Number of nano (10^-9) units of the amount.
+ # The value must be between -999,999,999 and +999,999,999 inclusive.
+ # If `units` is positive, `nanos` must be positive or zero.
+ # If `units` is zero, `nanos` can be positive, zero, or negative.
+ # If `units` is negative, `nanos` must be negative or zero.
+ # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+ "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+ },
+ "stringValue": "A String", # A text string value.
},
],
+ "metricName": "A String", # The metric name defined in the service configuration.
},
],
},
+ "serviceConfigId": "A String", # Specifies which version of service configuration should be used to process
+ # the request. If unspecified or no matching version can be found, the latest
+ # one will be used.
}
x__xgafv: string, V1 error format.
@@ -302,9 +302,6 @@
An object of the form:
{ # Response message for the AllocateQuota method.
- "operationId": "A String", # The same operation_id value used in the AllocateQuotaRequest. Used for
- # logging and diagnostics purposes.
- "serviceConfigId": "A String", # ID of the actual config used to process the request.
"allocateInfo": { # WARNING: DO NOT use this field until this warning message is removed.
"unusedArguments": [ # A list of label keys that were unused by the server in processing the
# request. Thus, for similar requests repeated in a certain future time
@@ -314,13 +311,15 @@
"A String",
],
},
+ "operationId": "A String", # The same operation_id value used in the AllocateQuotaRequest. Used for
+ # logging and diagnostics purposes.
"allocateErrors": [ # Indicates the decision of the allocate.
{ # Represents error information for QuotaOperation.
"subject": "A String", # Subject to whom this error applies. See the specific enum for more details
# on this field. For example, "clientip:<ip address of client>" or
# "project:<Google developer project id>".
- "description": "A String", # Free-form text that provides details on the cause of the error.
"code": "A String", # Error code.
+ "description": "A String", # Free-form text that provides details on the cause of the error.
},
],
"quotaMetrics": [ # Quota metrics to indicate the result of allocation. Depending on the
@@ -336,33 +335,12 @@
{ # Represents a set of metric values in the same metric.
# Each metric value in the set should have a unique combination of start time,
# end time, and label values.
- "metricName": "A String", # The metric name defined in the service configuration.
"metricValues": [ # The values in this metric.
{ # Represents a single metric value.
"startTime": "A String", # The start of the time period over which this metric value's measurement
# applies. The time period has different semantics for different metric
# types (cumulative, delta, and gauge). See the metric definition
# documentation in the service configuration for details.
- "moneyValue": { # Represents an amount of money with its currency type. # A money value.
- "nanos": 42, # Number of nano (10^-9) units of the amount.
- # The value must be between -999,999,999 and +999,999,999 inclusive.
- # If `units` is positive, `nanos` must be positive or zero.
- # If `units` is zero, `nanos` can be positive, zero, or negative.
- # If `units` is negative, `nanos` must be negative or zero.
- # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
- "units": "A String", # The whole units of the amount.
- # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- },
- "labels": { # The labels describing the metric value.
- # See comments on google.api.servicecontrol.v1.Operation.labels for
- # the overriding relationship.
- # Note that this map must not contain monitored resource labels.
- "a_key": "A String",
- },
- "stringValue": "A String", # A text string value.
- "doubleValue": 3.14, # A double precision floating point value.
- "int64Value": "A String", # A signed 64-bit integer value.
"distributionValue": { # Distribution represents a frequency distribution of double-valued sample # A distribution value.
# points. It contains the size of the population of sample points plus
# additional optional information:
@@ -371,10 +349,51 @@
# - the minimum and maximum of the samples
# - the sum-squared-deviation of the samples, used to compute variance
# - a histogram of the values of the sample points
+ "bucketCounts": [ # The number of samples in each histogram bucket. `bucket_counts` are
+ # optional. If present, they must sum to the `count` value.
+ #
+ # The buckets are defined below in `bucket_option`. There are N buckets.
+ # `bucket_counts[0]` is the number of samples in the underflow bucket.
+ # `bucket_counts[1]` to `bucket_counts[N-1]` are the numbers of samples
+ # in each of the finite buckets. And `bucket_counts[N] is the number
+ # of samples in the overflow bucket. See the comments of `bucket_option`
+ # below for more details.
+ #
+ # Any suffix of trailing zeros may be omitted.
+ "A String",
+ ],
+ "count": "A String", # The total number of samples in the distribution. Must be >= 0.
"sumOfSquaredDeviation": 3.14, # The sum of squared deviations from the mean:
# Sum[i=1..count]((x_i - mean)^2)
# where each x_i is a sample values. If `count` is zero then this field
# must be zero, otherwise validation of the request fails.
+ "linearBuckets": { # Describing buckets with constant width. # Buckets with constant width.
+ "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
+ # the total number of buckets is `num_finite_buckets` + 2.
+ # See comments on `bucket_options` for details.
+ "offset": 3.14, # The i'th linear bucket covers the interval
+ # [offset + (i-1) * width, offset + i * width)
+ # where i ranges from 1 to num_finite_buckets, inclusive.
+ "width": 3.14, # The i'th linear bucket covers the interval
+ # [offset + (i-1) * width, offset + i * width)
+ # where i ranges from 1 to num_finite_buckets, inclusive.
+ # Must be strictly positive.
+ },
+ "maximum": 3.14, # The maximum of the population of values. Ignored if `count` is zero.
+ "exponentialBuckets": { # Describing buckets with exponentially growing width. # Buckets with exponentially growing width.
+ "growthFactor": 3.14, # The i'th exponential bucket covers the interval
+ # [scale * growth_factor^(i-1), scale * growth_factor^i)
+ # where i ranges from 1 to num_finite_buckets inclusive.
+ # Must be larger than 1.0.
+ "scale": 3.14, # The i'th exponential bucket covers the interval
+ # [scale * growth_factor^(i-1), scale * growth_factor^i)
+ # where i ranges from 1 to num_finite_buckets inclusive.
+ # Must be > 0.
+ "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
+ # the total number of buckets is `num_finite_buckets` + 2.
+ # See comments on `bucket_options` for details.
+ },
+ "minimum": 3.14, # The minimum of the population of values. Ignored if `count` is zero.
"exemplars": [ # Example points. Must be in increasing order of `value` field.
{ # Exemplars are example points that may be used to annotate aggregated
# distribution values. They are metadata that gives information about a
@@ -383,7 +402,6 @@
# such as a example values and timestamps, origin, etc.
"value": 3.14, # Value of the exemplar point. This value determines to which bucket the
# exemplar belongs.
- "timestamp": "A String", # The observation (sampling) time of the above value.
"attachments": [ # Contextual information about the example value. Examples are:
#
# Trace: type.googleapis.com/google.monitoring.v3.SpanContext
@@ -399,50 +417,11 @@
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
+ "timestamp": "A String", # The observation (sampling) time of the above value.
},
],
- "exponentialBuckets": { # Describing buckets with exponentially growing width. # Buckets with exponentially growing width.
- "growthFactor": 3.14, # The i'th exponential bucket covers the interval
- # [scale * growth_factor^(i-1), scale * growth_factor^i)
- # where i ranges from 1 to num_finite_buckets inclusive.
- # Must be larger than 1.0.
- "scale": 3.14, # The i'th exponential bucket covers the interval
- # [scale * growth_factor^(i-1), scale * growth_factor^i)
- # where i ranges from 1 to num_finite_buckets inclusive.
- # Must be > 0.
- "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
- # the total number of buckets is `num_finite_buckets` + 2.
- # See comments on `bucket_options` for details.
- },
- "minimum": 3.14, # The minimum of the population of values. Ignored if `count` is zero.
- "linearBuckets": { # Describing buckets with constant width. # Buckets with constant width.
- "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
- # the total number of buckets is `num_finite_buckets` + 2.
- # See comments on `bucket_options` for details.
- "width": 3.14, # The i'th linear bucket covers the interval
- # [offset + (i-1) * width, offset + i * width)
- # where i ranges from 1 to num_finite_buckets, inclusive.
- # Must be strictly positive.
- "offset": 3.14, # The i'th linear bucket covers the interval
- # [offset + (i-1) * width, offset + i * width)
- # where i ranges from 1 to num_finite_buckets, inclusive.
- },
"mean": 3.14, # The arithmetic mean of the samples in the distribution. If `count` is
# zero then this field must be zero.
- "count": "A String", # The total number of samples in the distribution. Must be >= 0.
- "bucketCounts": [ # The number of samples in each histogram bucket. `bucket_counts` are
- # optional. If present, they must sum to the `count` value.
- #
- # The buckets are defined below in `bucket_option`. There are N buckets.
- # `bucket_counts[0]` is the number of samples in the underflow bucket.
- # `bucket_counts[1]` to `bucket_counts[N-1]` are the numbers of samples
- # in each of the finite buckets. And `bucket_counts[N] is the number
- # of samples in the overflow bucket. See the comments of `bucket_option`
- # below for more details.
- #
- # Any suffix of trailing zeros may be omitted.
- "A String",
- ],
"explicitBuckets": { # Describing buckets with arbitrary user-provided width. # Buckets with arbitrary user-provided width.
"bounds": [ # 'bound' is a list of strictly increasing boundaries between
# buckets. Note that a list of length N-1 defines N buckets because
@@ -462,15 +441,36 @@
3.14,
],
},
- "maximum": 3.14, # The maximum of the population of values. Ignored if `count` is zero.
},
- "boolValue": True or False, # A boolean value.
+ "labels": { # The labels describing the metric value.
+ # See comments on google.api.servicecontrol.v1.Operation.labels for
+ # the overriding relationship.
+ # Note that this map must not contain monitored resource labels.
+ "a_key": "A String",
+ },
+ "doubleValue": 3.14, # A double precision floating point value.
"endTime": "A String", # The end of the time period over which this metric value's measurement
# applies.
+ "boolValue": True or False, # A boolean value.
+ "int64Value": "A String", # A signed 64-bit integer value.
+ "moneyValue": { # Represents an amount of money with its currency type. # A money value.
+ "nanos": 42, # Number of nano (10^-9) units of the amount.
+ # The value must be between -999,999,999 and +999,999,999 inclusive.
+ # If `units` is positive, `nanos` must be positive or zero.
+ # If `units` is zero, `nanos` can be positive, zero, or negative.
+ # If `units` is negative, `nanos` must be negative or zero.
+ # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+ "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+ },
+ "stringValue": "A String", # A text string value.
},
],
+ "metricName": "A String", # The metric name defined in the service configuration.
},
],
+ "serviceConfigId": "A String", # ID of the actual config used to process the request.
}</pre>
</div>
@@ -504,25 +504,114 @@
The object takes the form of:
{ # Request message for the Check method.
- "skipActivationCheck": True or False, # Indicates if service activation check should be skipped for this request.
- # Default behavior is to perform the check and apply relevant quota.
- # WARNING: Setting this flag to "true" will disable quota enforcement.
+ "serviceConfigId": "A String", # Specifies which version of service configuration should be used to process
+ # the request.
+ #
+ # If unspecified or no matching version can be found, the
+ # latest one will be used.
"operation": { # Represents information regarding an operation. # The operation to be checked.
- "operationId": "A String", # Identity of the operation. This must be unique within the scope of the
- # service that generated the operation. If the service calls
- # Check() and Report() on the same operation, the two calls should carry
- # the same id.
- #
- # UUID version 4 is recommended, though not required.
- # In scenarios where an operation is computed from existing information
- # and an idempotent id is desirable for deduplication purpose, UUID version 5
- # is recommended. See RFC 4122 for details.
- "operationName": "A String", # Fully qualified name of the operation. Reserved for future use.
- "endTime": "A String", # End time of the operation.
- # Required when the operation is used in ServiceController.Report,
- # but optional when the operation is used in ServiceController.Check.
"startTime": "A String", # Required. Start time of the operation.
- "importance": "A String", # DO NOT USE. This is an experimental field.
+ "traceSpans": [ # Unimplemented. A list of Cloud Trace spans. The span names shall contain
+ # the id of the destination project which can be either the produce or the
+ # consumer project.
+ { # A span represents a single operation within a trace. Spans can be
+ # nested to form a trace tree. Often, a trace contains a root span
+ # that describes the end-to-end latency, and one or more subspans for
+ # its sub-operations. A trace can also contain multiple root spans,
+ # or none at all. Spans do not need to be contiguous&mdash;there may be
+ # gaps or overlaps between spans in a trace.
+ "spanKind": "A String", # Distinguishes between spans generated in a particular context. For example,
+ # two spans with the same name may be distinguished using `CLIENT` (caller)
+ # and `SERVER` (callee) to identify an RPC call.
+ "sameProcessAsParentSpan": True or False, # (Optional) Set this parameter to indicate whether this span is in
+ # the same process as its parent. If you do not set this parameter,
+ # Stackdriver Trace is unable to take advantage of this helpful
+ # information.
+ "childSpanCount": 42, # An optional number of child spans that were generated while this span
+ # was active. If set, allows implementation to detect missing child spans.
+ "startTime": "A String", # The start time of the span. On the client side, this is the time kept by
+ # the local machine where the span execution starts. On the server side, this
+ # is the time when the server's application handler starts running.
+ "displayName": { # Represents a string that might be shortened to a specified length. # A description of the span's operation (up to 128 bytes).
+ # Stackdriver Trace displays the description in the
+ # Google Cloud Platform Console.
+ # For example, the display name can be a qualified method name or a file name
+ # and a line number where the operation is called. A best practice is to use
+ # the same display name within an application and at the same call point.
+ # This makes it easier to correlate spans in different traces.
+ "value": "A String", # The shortened string. For example, if the original string is 500
+ # bytes long and the limit of the string is 128 bytes, then
+ # `value` contains the first 128 bytes of the 500-byte string.
+ #
+ # Truncation always happens on a UTF8 character boundary. If there
+ # are multi-byte characters in the string, then the length of the
+ # shortened string might be less than the size limit.
+ "truncatedByteCount": 42, # The number of bytes removed from the original string. If this
+ # value is 0, then the string was not shortened.
+ },
+ "endTime": "A String", # The end time of the span. On the client side, this is the time kept by
+ # the local machine where the span execution ends. On the server side, this
+ # is the time when the server application handler stops running.
+ "attributes": { # A set of attributes, each in the format `[KEY]:[VALUE]`. # A set of attributes on the span. You can have up to 32 attributes per
+ # span.
+ "attributeMap": { # The set of attributes. Each attribute's key can be up to 128 bytes
+ # long. The value can be a string up to 256 bytes, a signed 64-bit integer,
+ # or the Boolean values `true` and `false`. For example:
+ #
+ # "/instance_id": "my-instance"
+ # "/http/user_agent": ""
+ # "/http/request_bytes": 300
+ # "abc.com/myattribute": true
+ "a_key": { # The allowed types for [VALUE] in a `[KEY]:[VALUE]` attribute.
+ "stringValue": { # Represents a string that might be shortened to a specified length. # A string up to 256 bytes long.
+ "value": "A String", # The shortened string. For example, if the original string is 500
+ # bytes long and the limit of the string is 128 bytes, then
+ # `value` contains the first 128 bytes of the 500-byte string.
+ #
+ # Truncation always happens on a UTF8 character boundary. If there
+ # are multi-byte characters in the string, then the length of the
+ # shortened string might be less than the size limit.
+ "truncatedByteCount": 42, # The number of bytes removed from the original string. If this
+ # value is 0, then the string was not shortened.
+ },
+ "intValue": "A String", # A 64-bit signed integer.
+ "boolValue": True or False, # A Boolean value represented by `true` or `false`.
+ },
+ },
+ "droppedAttributesCount": 42, # The number of attributes that were discarded. Attributes can be discarded
+ # because their keys are too long or because there are too many attributes.
+ # If this value is 0 then all attributes are valid.
+ },
+ "parentSpanId": "A String", # The [SPAN_ID] of this span's parent span. If this is a root span,
+ # then this field must be empty.
+ "name": "A String", # The resource name of the span in the following format:
+ #
+ # projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/SPAN_ID is a unique identifier for a trace within a project;
+ # it is a 32-character hexadecimal encoding of a 16-byte array.
+ #
+ # [SPAN_ID] is a unique identifier for a span within a trace; it
+ # is a 16-character hexadecimal encoding of an 8-byte array.
+ "spanId": "A String", # The [SPAN_ID] portion of the span's resource name.
+ "status": { # The `Status` type defines a logical error model that is suitable for # An optional final status for this span.
+ # 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).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ },
+ },
+ ],
"labels": { # Labels describing the operation. Only the following labels are allowed:
#
# - Labels describing monitored resources as defined in
@@ -541,116 +630,15 @@
# Kubernetes Engine.
"a_key": "A String",
},
- "resources": [ # The resources that are involved in the operation.
- # The maximum supported number of entries in this field is 100.
- { # Describes a resource associated with this operation.
- "resourceName": "A String", # Name of the resource. This is used for auditing purposes.
- "resourceLocation": "A String", # The location of the resource. If not empty, the resource will be checked
- # against location policy. The value must be a valid zone, region or
- # multiregion. For example: "europe-west4" or "northamerica-northeast1-a"
- "resourceContainer": "A String", # The identifier of the parent of this resource instance.
- # Must be in one of the following formats:
- # - “projects/<project-id or project-number>”
- # - “folders/<folder-id>”
- # - “organizations/<organization-id>”
- },
- ],
- "logEntries": [ # Represents information to be logged.
- { # An individual log entry.
- "httpRequest": { # A common proto for logging HTTP requests. Only contains semantics # Optional. Information about the HTTP request associated with this
- # log entry, if applicable.
- # defined by the HTTP specification. Product-specific logging
- # information MUST be defined in a separate message.
- "referer": "A String", # The referer URL of the request, as defined in
- # [HTTP/1.1 Header Field
- # Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
- "latency": "A String", # The request processing latency on the server, from the time the request was
- # received until the response was sent.
- "userAgent": "A String", # The user agent sent by the client. Example:
- # `"Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET
- # CLR 1.0.3705)"`.
- "cacheFillBytes": "A String", # The number of HTTP response bytes inserted into cache. Set only when a
- # cache fill was attempted.
- "requestMethod": "A String", # The request method. Examples: `"GET"`, `"HEAD"`, `"PUT"`, `"POST"`.
- "requestSize": "A String", # The size of the HTTP request message in bytes, including the request
- # headers and the request body.
- "responseSize": "A String", # The size of the HTTP response message sent back to the client, in bytes,
- # including the response headers and the response body.
- "protocol": "A String", # Protocol used for the request. Examples: "HTTP/1.1", "HTTP/2", "websocket"
- "requestUrl": "A String", # The scheme (http, https), the host name, the path, and the query
- # portion of the URL that was requested.
- # Example: `"http://example.com/some/info?color=red"`.
- "remoteIp": "A String", # The IP address (IPv4 or IPv6) of the client that issued the HTTP
- # request. Examples: `"192.168.1.1"`, `"FE80::0202:B3FF:FE1E:8329"`.
- "serverIp": "A String", # The IP address (IPv4 or IPv6) of the origin server that the request was
- # sent to.
- "cacheLookup": True or False, # Whether or not a cache lookup was attempted.
- "cacheHit": True or False, # Whether or not an entity was served from cache
- # (with or without validation).
- "cacheValidatedWithOriginServer": True or False, # Whether or not the response was validated with the origin server before
- # being served from cache. This field is only meaningful if `cache_hit` is
- # True.
- "status": 42, # The response code indicating the status of the response.
- # Examples: 200, 404.
- },
- "operation": { # Additional information about a potentially long-running operation with which # Optional. Information about an operation associated with the log entry, if
- # applicable.
- # a log entry is associated.
- "id": "A String", # Optional. An arbitrary operation identifier. Log entries with the
- # same identifier are assumed to be part of the same operation.
- "producer": "A String", # Optional. An arbitrary producer identifier. The combination of
- # `id` and `producer` must be globally unique. Examples for `producer`:
- # `"MyDivision.MyBigCompany.com"`, `"github.com/MyProject/MyApplication"`.
- "first": True or False, # Optional. Set this to True if this is the first log entry in the operation.
- "last": True or False, # Optional. Set this to True if this is the last log entry in the operation.
- },
- "name": "A String", # Required. The log to which this log entry belongs. Examples: `"syslog"`,
- # `"book_log"`.
- "insertId": "A String", # A unique ID for the log entry used for deduplication. If omitted,
- # the implementation will generate one based on operation_id.
- "textPayload": "A String", # The log entry payload, represented as a Unicode string (UTF-8).
- "protoPayload": { # The log entry payload, represented as a protocol buffer that is
- # expressed as a JSON object. The only accepted type currently is
- # AuditLog.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- "labels": { # A set of user-defined (key, value) data that provides additional
- # information about the log entry.
- "a_key": "A String",
- },
- "trace": "A String", # Optional. Resource name of the trace associated with the log entry, if any.
- # If this field contains a relative resource name, you can assume the name is
- # relative to `//tracing.googleapis.com`. Example:
- # `projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824`
- "severity": "A String", # The severity of the log entry. The default value is
- # `LogSeverity.DEFAULT`.
- "sourceLocation": { # Additional information about the source code location that produced the log # Optional. Source code location information associated with the log entry,
- # if any.
- # entry.
- "line": "A String", # Optional. Line within the source file. 1-based; 0 indicates no line number
- # available.
- "file": "A String", # Optional. Source file name. Depending on the runtime environment, this
- # might be a simple name or a fully-qualified name.
- "function": "A String", # Optional. Human-readable name of the function or method being invoked, with
- # optional context such as the class or package name. This information may be
- # used in contexts such as the logs viewer, where a file and line number are
- # less meaningful. The format can vary by language. For example:
- # `qual.if.ied.Class.method` (Java), `dir/package.func` (Go), `function`
- # (Python).
- },
- "structPayload": { # The log entry payload, represented as a structure that
- # is expressed as a JSON object.
- "a_key": "", # Properties of the object.
- },
- "timestamp": "A String", # The time the event described by the log entry occurred. If
- # omitted, defaults to operation start time.
- },
- ],
- "userLabels": { # User defined labels for the resource that this operation is associated
- # with. Only a combination of 1000 user labels per consumer project are
- # allowed.
- "a_key": "A String",
- },
+ "operationId": "A String", # Identity of the operation. This must be unique within the scope of the
+ # service that generated the operation. If the service calls
+ # Check() and Report() on the same operation, the two calls should carry
+ # the same id.
+ #
+ # UUID version 4 is recommended, though not required.
+ # In scenarios where an operation is computed from existing information
+ # and an idempotent id is desirable for deduplication purpose, UUID version 5
+ # is recommended. See RFC 4122 for details.
"metricValueSets": [ # Represents information about this operation. Each MetricValueSet
# corresponds to a metric defined in the service configuration.
# The data type used in the MetricValueSet must agree with
@@ -664,33 +652,12 @@
{ # Represents a set of metric values in the same metric.
# Each metric value in the set should have a unique combination of start time,
# end time, and label values.
- "metricName": "A String", # The metric name defined in the service configuration.
"metricValues": [ # The values in this metric.
{ # Represents a single metric value.
"startTime": "A String", # The start of the time period over which this metric value's measurement
# applies. The time period has different semantics for different metric
# types (cumulative, delta, and gauge). See the metric definition
# documentation in the service configuration for details.
- "moneyValue": { # Represents an amount of money with its currency type. # A money value.
- "nanos": 42, # Number of nano (10^-9) units of the amount.
- # The value must be between -999,999,999 and +999,999,999 inclusive.
- # If `units` is positive, `nanos` must be positive or zero.
- # If `units` is zero, `nanos` can be positive, zero, or negative.
- # If `units` is negative, `nanos` must be negative or zero.
- # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
- "units": "A String", # The whole units of the amount.
- # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- },
- "labels": { # The labels describing the metric value.
- # See comments on google.api.servicecontrol.v1.Operation.labels for
- # the overriding relationship.
- # Note that this map must not contain monitored resource labels.
- "a_key": "A String",
- },
- "stringValue": "A String", # A text string value.
- "doubleValue": 3.14, # A double precision floating point value.
- "int64Value": "A String", # A signed 64-bit integer value.
"distributionValue": { # Distribution represents a frequency distribution of double-valued sample # A distribution value.
# points. It contains the size of the population of sample points plus
# additional optional information:
@@ -699,10 +666,51 @@
# - the minimum and maximum of the samples
# - the sum-squared-deviation of the samples, used to compute variance
# - a histogram of the values of the sample points
+ "bucketCounts": [ # The number of samples in each histogram bucket. `bucket_counts` are
+ # optional. If present, they must sum to the `count` value.
+ #
+ # The buckets are defined below in `bucket_option`. There are N buckets.
+ # `bucket_counts[0]` is the number of samples in the underflow bucket.
+ # `bucket_counts[1]` to `bucket_counts[N-1]` are the numbers of samples
+ # in each of the finite buckets. And `bucket_counts[N] is the number
+ # of samples in the overflow bucket. See the comments of `bucket_option`
+ # below for more details.
+ #
+ # Any suffix of trailing zeros may be omitted.
+ "A String",
+ ],
+ "count": "A String", # The total number of samples in the distribution. Must be >= 0.
"sumOfSquaredDeviation": 3.14, # The sum of squared deviations from the mean:
# Sum[i=1..count]((x_i - mean)^2)
# where each x_i is a sample values. If `count` is zero then this field
# must be zero, otherwise validation of the request fails.
+ "linearBuckets": { # Describing buckets with constant width. # Buckets with constant width.
+ "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
+ # the total number of buckets is `num_finite_buckets` + 2.
+ # See comments on `bucket_options` for details.
+ "offset": 3.14, # The i'th linear bucket covers the interval
+ # [offset + (i-1) * width, offset + i * width)
+ # where i ranges from 1 to num_finite_buckets, inclusive.
+ "width": 3.14, # The i'th linear bucket covers the interval
+ # [offset + (i-1) * width, offset + i * width)
+ # where i ranges from 1 to num_finite_buckets, inclusive.
+ # Must be strictly positive.
+ },
+ "maximum": 3.14, # The maximum of the population of values. Ignored if `count` is zero.
+ "exponentialBuckets": { # Describing buckets with exponentially growing width. # Buckets with exponentially growing width.
+ "growthFactor": 3.14, # The i'th exponential bucket covers the interval
+ # [scale * growth_factor^(i-1), scale * growth_factor^i)
+ # where i ranges from 1 to num_finite_buckets inclusive.
+ # Must be larger than 1.0.
+ "scale": 3.14, # The i'th exponential bucket covers the interval
+ # [scale * growth_factor^(i-1), scale * growth_factor^i)
+ # where i ranges from 1 to num_finite_buckets inclusive.
+ # Must be > 0.
+ "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
+ # the total number of buckets is `num_finite_buckets` + 2.
+ # See comments on `bucket_options` for details.
+ },
+ "minimum": 3.14, # The minimum of the population of values. Ignored if `count` is zero.
"exemplars": [ # Example points. Must be in increasing order of `value` field.
{ # Exemplars are example points that may be used to annotate aggregated
# distribution values. They are metadata that gives information about a
@@ -711,7 +719,6 @@
# such as a example values and timestamps, origin, etc.
"value": 3.14, # Value of the exemplar point. This value determines to which bucket the
# exemplar belongs.
- "timestamp": "A String", # The observation (sampling) time of the above value.
"attachments": [ # Contextual information about the example value. Examples are:
#
# Trace: type.googleapis.com/google.monitoring.v3.SpanContext
@@ -727,50 +734,11 @@
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
+ "timestamp": "A String", # The observation (sampling) time of the above value.
},
],
- "exponentialBuckets": { # Describing buckets with exponentially growing width. # Buckets with exponentially growing width.
- "growthFactor": 3.14, # The i'th exponential bucket covers the interval
- # [scale * growth_factor^(i-1), scale * growth_factor^i)
- # where i ranges from 1 to num_finite_buckets inclusive.
- # Must be larger than 1.0.
- "scale": 3.14, # The i'th exponential bucket covers the interval
- # [scale * growth_factor^(i-1), scale * growth_factor^i)
- # where i ranges from 1 to num_finite_buckets inclusive.
- # Must be > 0.
- "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
- # the total number of buckets is `num_finite_buckets` + 2.
- # See comments on `bucket_options` for details.
- },
- "minimum": 3.14, # The minimum of the population of values. Ignored if `count` is zero.
- "linearBuckets": { # Describing buckets with constant width. # Buckets with constant width.
- "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
- # the total number of buckets is `num_finite_buckets` + 2.
- # See comments on `bucket_options` for details.
- "width": 3.14, # The i'th linear bucket covers the interval
- # [offset + (i-1) * width, offset + i * width)
- # where i ranges from 1 to num_finite_buckets, inclusive.
- # Must be strictly positive.
- "offset": 3.14, # The i'th linear bucket covers the interval
- # [offset + (i-1) * width, offset + i * width)
- # where i ranges from 1 to num_finite_buckets, inclusive.
- },
"mean": 3.14, # The arithmetic mean of the samples in the distribution. If `count` is
# zero then this field must be zero.
- "count": "A String", # The total number of samples in the distribution. Must be >= 0.
- "bucketCounts": [ # The number of samples in each histogram bucket. `bucket_counts` are
- # optional. If present, they must sum to the `count` value.
- #
- # The buckets are defined below in `bucket_option`. There are N buckets.
- # `bucket_counts[0]` is the number of samples in the underflow bucket.
- # `bucket_counts[1]` to `bucket_counts[N-1]` are the numbers of samples
- # in each of the finite buckets. And `bucket_counts[N] is the number
- # of samples in the overflow bucket. See the comments of `bucket_option`
- # below for more details.
- #
- # Any suffix of trailing zeros may be omitted.
- "A String",
- ],
"explicitBuckets": { # Describing buckets with arbitrary user-provided width. # Buckets with arbitrary user-provided width.
"bounds": [ # 'bound' is a list of strictly increasing boundaries between
# buckets. Note that a list of length N-1 defines N buckets because
@@ -790,121 +758,160 @@
3.14,
],
},
- "maximum": 3.14, # The maximum of the population of values. Ignored if `count` is zero.
},
- "boolValue": True or False, # A boolean value.
+ "labels": { # The labels describing the metric value.
+ # See comments on google.api.servicecontrol.v1.Operation.labels for
+ # the overriding relationship.
+ # Note that this map must not contain monitored resource labels.
+ "a_key": "A String",
+ },
+ "doubleValue": 3.14, # A double precision floating point value.
"endTime": "A String", # The end of the time period over which this metric value's measurement
# applies.
+ "boolValue": True or False, # A boolean value.
+ "int64Value": "A String", # A signed 64-bit integer value.
+ "moneyValue": { # Represents an amount of money with its currency type. # A money value.
+ "nanos": 42, # Number of nano (10^-9) units of the amount.
+ # The value must be between -999,999,999 and +999,999,999 inclusive.
+ # If `units` is positive, `nanos` must be positive or zero.
+ # If `units` is zero, `nanos` can be positive, zero, or negative.
+ # If `units` is negative, `nanos` must be negative or zero.
+ # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+ "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+ },
+ "stringValue": "A String", # A text string value.
},
],
+ "metricName": "A String", # The metric name defined in the service configuration.
},
],
- "traceSpans": [ # Unimplemented. A list of Cloud Trace spans. The span names shall contain
- # the id of the destination project which can be either the produce or the
- # consumer project.
- { # A span represents a single operation within a trace. Spans can be
- # nested to form a trace tree. Often, a trace contains a root span
- # that describes the end-to-end latency, and one or more subspans for
- # its sub-operations. A trace can also contain multiple root spans,
- # or none at all. Spans do not need to be contiguous&mdash;there may be
- # gaps or overlaps between spans in a trace.
- "childSpanCount": 42, # An optional number of child spans that were generated while this span
- # was active. If set, allows implementation to detect missing child spans.
- "sameProcessAsParentSpan": True or False, # (Optional) Set this parameter to indicate whether this span is in
- # the same process as its parent. If you do not set this parameter,
- # Stackdriver Trace is unable to take advantage of this helpful
- # information.
- "status": { # The `Status` type defines a logical error model that is suitable for # An optional final status for this span.
- # 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).
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
+ "userLabels": { # User defined labels for the resource that this operation is associated
+ # with. Only a combination of 1000 user labels per consumer project are
+ # allowed.
+ "a_key": "A String",
+ },
+ "logEntries": [ # Represents information to be logged.
+ { # An individual log entry.
+ "textPayload": "A String", # The log entry payload, represented as a Unicode string (UTF-8).
+ "sourceLocation": { # Additional information about the source code location that produced the log # Optional. Source code location information associated with the log entry,
+ # if any.
+ # entry.
+ "function": "A String", # Optional. Human-readable name of the function or method being invoked, with
+ # optional context such as the class or package name. This information may be
+ # used in contexts such as the logs viewer, where a file and line number are
+ # less meaningful. The format can vary by language. For example:
+ # `qual.if.ied.Class.method` (Java), `dir/package.func` (Go), `function`
+ # (Python).
+ "line": "A String", # Optional. Line within the source file. 1-based; 0 indicates no line number
+ # available.
+ "file": "A String", # Optional. Source file name. Depending on the runtime environment, this
+ # might be a simple name or a fully-qualified name.
},
- "name": "A String", # The resource name of the span in the following format:
- #
- # projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/SPAN_ID is a unique identifier for a trace within a project;
- # it is a 32-character hexadecimal encoding of a 16-byte array.
- #
- # [SPAN_ID] is a unique identifier for a span within a trace; it
- # is a 16-character hexadecimal encoding of an 8-byte array.
- "attributes": { # A set of attributes, each in the format `[KEY]:[VALUE]`. # A set of attributes on the span. You can have up to 32 attributes per
- # span.
- "droppedAttributesCount": 42, # The number of attributes that were discarded. Attributes can be discarded
- # because their keys are too long or because there are too many attributes.
- # If this value is 0 then all attributes are valid.
- "attributeMap": { # The set of attributes. Each attribute's key can be up to 128 bytes
- # long. The value can be a string up to 256 bytes, a signed 64-bit integer,
- # or the Boolean values `true` and `false`. For example:
- #
- # "/instance_id": "my-instance"
- # "/http/user_agent": ""
- # "/http/request_bytes": 300
- # "abc.com/myattribute": true
- "a_key": { # The allowed types for [VALUE] in a `[KEY]:[VALUE]` attribute.
- "intValue": "A String", # A 64-bit signed integer.
- "stringValue": { # Represents a string that might be shortened to a specified length. # A string up to 256 bytes long.
- "truncatedByteCount": 42, # The number of bytes removed from the original string. If this
- # value is 0, then the string was not shortened.
- "value": "A String", # The shortened string. For example, if the original string is 500
- # bytes long and the limit of the string is 128 bytes, then
- # `value` contains the first 128 bytes of the 500-byte string.
- #
- # Truncation always happens on a UTF8 character boundary. If there
- # are multi-byte characters in the string, then the length of the
- # shortened string might be less than the size limit.
- },
- "boolValue": True or False, # A Boolean value represented by `true` or `false`.
- },
- },
+ "severity": "A String", # The severity of the log entry. The default value is
+ # `LogSeverity.DEFAULT`.
+ "structPayload": { # The log entry payload, represented as a structure that
+ # is expressed as a JSON object.
+ "a_key": "", # Properties of the object.
},
- "spanId": "A String", # The [SPAN_ID] portion of the span's resource name.
- "parentSpanId": "A String", # The [SPAN_ID] of this span's parent span. If this is a root span,
- # then this field must be empty.
- "endTime": "A String", # The end time of the span. On the client side, this is the time kept by
- # the local machine where the span execution ends. On the server side, this
- # is the time when the server application handler stops running.
- "spanKind": "A String", # Distinguishes between spans generated in a particular context. For example,
- # two spans with the same name may be distinguished using `CLIENT` (caller)
- # and `SERVER` (callee) to identify an RPC call.
- "startTime": "A String", # The start time of the span. On the client side, this is the time kept by
- # the local machine where the span execution starts. On the server side, this
- # is the time when the server's application handler starts running.
- "displayName": { # Represents a string that might be shortened to a specified length. # A description of the span's operation (up to 128 bytes).
- # Stackdriver Trace displays the description in the
- # Google Cloud Platform Console.
- # For example, the display name can be a qualified method name or a file name
- # and a line number where the operation is called. A best practice is to use
- # the same display name within an application and at the same call point.
- # This makes it easier to correlate spans in different traces.
- "truncatedByteCount": 42, # The number of bytes removed from the original string. If this
- # value is 0, then the string was not shortened.
- "value": "A String", # The shortened string. For example, if the original string is 500
- # bytes long and the limit of the string is 128 bytes, then
- # `value` contains the first 128 bytes of the 500-byte string.
- #
- # Truncation always happens on a UTF8 character boundary. If there
- # are multi-byte characters in the string, then the length of the
- # shortened string might be less than the size limit.
+ "labels": { # A set of user-defined (key, value) data that provides additional
+ # information about the log entry.
+ "a_key": "A String",
},
+ "protoPayload": { # The log entry payload, represented as a protocol buffer that is
+ # expressed as a JSON object. The only accepted type currently is
+ # AuditLog.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "httpRequest": { # A common proto for logging HTTP requests. Only contains semantics # Optional. Information about the HTTP request associated with this
+ # log entry, if applicable.
+ # defined by the HTTP specification. Product-specific logging
+ # information MUST be defined in a separate message.
+ "protocol": "A String", # Protocol used for the request. Examples: "HTTP/1.1", "HTTP/2", "websocket"
+ "cacheValidatedWithOriginServer": True or False, # Whether or not the response was validated with the origin server before
+ # being served from cache. This field is only meaningful if `cache_hit` is
+ # True.
+ "cacheFillBytes": "A String", # The number of HTTP response bytes inserted into cache. Set only when a
+ # cache fill was attempted.
+ "requestSize": "A String", # The size of the HTTP request message in bytes, including the request
+ # headers and the request body.
+ "responseSize": "A String", # The size of the HTTP response message sent back to the client, in bytes,
+ # including the response headers and the response body.
+ "serverIp": "A String", # The IP address (IPv4 or IPv6) of the origin server that the request was
+ # sent to.
+ "referer": "A String", # The referer URL of the request, as defined in
+ # [HTTP/1.1 Header Field
+ # Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
+ "cacheHit": True or False, # Whether or not an entity was served from cache
+ # (with or without validation).
+ "latency": "A String", # The request processing latency on the server, from the time the request was
+ # received until the response was sent.
+ "requestUrl": "A String", # The scheme (http, https), the host name, the path, and the query
+ # portion of the URL that was requested.
+ # Example: `"http://example.com/some/info?color=red"`.
+ "cacheLookup": True or False, # Whether or not a cache lookup was attempted.
+ "requestMethod": "A String", # The request method. Examples: `"GET"`, `"HEAD"`, `"PUT"`, `"POST"`.
+ "remoteIp": "A String", # The IP address (IPv4 or IPv6) of the client that issued the HTTP
+ # request. Examples: `"192.168.1.1"`, `"FE80::0202:B3FF:FE1E:8329"`.
+ "userAgent": "A String", # The user agent sent by the client. Example:
+ # `"Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET
+ # CLR 1.0.3705)"`.
+ "status": 42, # The response code indicating the status of the response.
+ # Examples: 200, 404.
+ },
+ "operation": { # Additional information about a potentially long-running operation with which # Optional. Information about an operation associated with the log entry, if
+ # applicable.
+ # a log entry is associated.
+ "first": True or False, # Optional. Set this to True if this is the first log entry in the operation.
+ "id": "A String", # Optional. An arbitrary operation identifier. Log entries with the
+ # same identifier are assumed to be part of the same operation.
+ "producer": "A String", # Optional. An arbitrary producer identifier. The combination of
+ # `id` and `producer` must be globally unique. Examples for `producer`:
+ # `"MyDivision.MyBigCompany.com"`, `"github.com/MyProject/MyApplication"`.
+ "last": True or False, # Optional. Set this to True if this is the last log entry in the operation.
+ },
+ "name": "A String", # Required. The log to which this log entry belongs. Examples: `"syslog"`,
+ # `"book_log"`.
+ "trace": "A String", # Optional. Resource name of the trace associated with the log entry, if any.
+ # If this field contains a relative resource name, you can assume the name is
+ # relative to `//tracing.googleapis.com`. Example:
+ # `projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824`
+ "timestamp": "A String", # The time the event described by the log entry occurred. If
+ # omitted, defaults to operation start time.
+ "insertId": "A String", # A unique ID for the log entry used for deduplication. If omitted,
+ # the implementation will generate one based on operation_id.
},
],
+ "importance": "A String", # DO NOT USE. This is an experimental field.
"quotaProperties": { # Represents the properties needed for quota operations. # Represents the properties needed for quota check. Applicable only if this
# operation is for a quota check request. If this is not specified, no quota
# check will be performed.
"quotaMode": "A String", # Quota mode for this operation.
},
+ "operationName": "A String", # Fully qualified name of the operation. Reserved for future use.
+ "resources": [ # The resources that are involved in the operation.
+ # The maximum supported number of entries in this field is 100.
+ { # Describes a resource associated with this operation.
+ "resourceContainer": "A String", # The identifier of the parent of this resource instance.
+ # Must be in one of the following formats:
+ # - “projects/<project-id or project-number>”
+ # - “folders/<folder-id>”
+ # - “organizations/<organization-id>”
+ "resourceName": "A String", # Name of the resource. This is used for auditing purposes.
+ "resourceLocation": "A String", # The location of the resource. If not empty, the resource will be checked
+ # against location policy. The value must be a valid zone, region or
+ # multiregion. For example: "europe-west4" or "northamerica-northeast1-a"
+ },
+ ],
+ "endTime": "A String", # End time of the operation.
+ # Required when the operation is used in ServiceController.Report,
+ # but optional when the operation is used in ServiceController.Check.
+ "extensions": [ # Unimplemented.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
"consumerId": "A String", # Identity of the consumer who is using the service.
# This field should be filled in for the operations initiated by a
# consumer, but not for service-initiated operations that are
@@ -919,11 +926,9 @@
# - api`_`key:API_KEY.
},
"requestProjectSettings": True or False, # Requests the project settings to be returned as part of the check response.
- "serviceConfigId": "A String", # Specifies which version of service configuration should be used to process
- # the request.
- #
- # If unspecified or no matching version can be found, the
- # latest one will be used.
+ "skipActivationCheck": True or False, # Indicates if service activation check should be skipped for this request.
+ # Default behavior is to perform the check and apply relevant quota.
+ # WARNING: Setting this flag to "true" will disable quota enforcement.
}
x__xgafv: string, V1 error format.
@@ -935,6 +940,197 @@
An object of the form:
{ # Response message for the Check method.
+ "checkInfo": { # Contains additional information about the check operation. # Feedback data returned from the server during processing a Check request.
+ "consumerInfo": { # `ConsumerInfo` provides information about the consumer. # Consumer info of this check.
+ "type": "A String", # The type of the consumer which should have been defined in
+ # [Google Resource Manager](https://cloud.google.com/resource-manager/).
+ "consumerNumber": "A String", # The consumer identity number, can be Google cloud project number, folder
+ # number or organization number e.g. 1234567890. A value of 0 indicates no
+ # consumer number is found.
+ "projectNumber": "A String", # The Google cloud project number, e.g. 1234567890. A value of 0 indicates
+ # no project number is found.
+ #
+ # NOTE: This field is deprecated after Chemist support flexible consumer
+ # id. New code should not depend on this field anymore.
+ },
+ "unusedArguments": [ # A list of fields and label keys that are ignored by the server.
+ # The client doesn't need to send them for following requests to improve
+ # performance and allow better aggregation.
+ "A String",
+ ],
+ },
+ "quotaInfo": { # Contains the quota information for a quota check response. # Quota information for the check request associated with this response.
+ "quotaMetrics": [ # Quota metrics to indicate the usage. Depending on the check request, one or
+ # more of the following metrics will be included:
+ #
+ # 1. For rate quota, per quota group or per quota metric incremental usage
+ # will be specified using the following delta metric:
+ # "serviceruntime.googleapis.com/api/consumer/quota_used_count"
+ #
+ # 2. For allocation quota, per quota metric total usage will be specified
+ # using the following gauge metric:
+ # "serviceruntime.googleapis.com/allocation/consumer/quota_used_count"
+ #
+ # 3. For both rate quota and allocation quota, the quota limit reached
+ # condition will be specified using the following boolean metric:
+ # "serviceruntime.googleapis.com/quota/exceeded"
+ { # Represents a set of metric values in the same metric.
+ # Each metric value in the set should have a unique combination of start time,
+ # end time, and label values.
+ "metricValues": [ # The values in this metric.
+ { # Represents a single metric value.
+ "startTime": "A String", # The start of the time period over which this metric value's measurement
+ # applies. The time period has different semantics for different metric
+ # types (cumulative, delta, and gauge). See the metric definition
+ # documentation in the service configuration for details.
+ "distributionValue": { # Distribution represents a frequency distribution of double-valued sample # A distribution value.
+ # points. It contains the size of the population of sample points plus
+ # additional optional information:
+ #
+ # - the arithmetic mean of the samples
+ # - the minimum and maximum of the samples
+ # - the sum-squared-deviation of the samples, used to compute variance
+ # - a histogram of the values of the sample points
+ "bucketCounts": [ # The number of samples in each histogram bucket. `bucket_counts` are
+ # optional. If present, they must sum to the `count` value.
+ #
+ # The buckets are defined below in `bucket_option`. There are N buckets.
+ # `bucket_counts[0]` is the number of samples in the underflow bucket.
+ # `bucket_counts[1]` to `bucket_counts[N-1]` are the numbers of samples
+ # in each of the finite buckets. And `bucket_counts[N] is the number
+ # of samples in the overflow bucket. See the comments of `bucket_option`
+ # below for more details.
+ #
+ # Any suffix of trailing zeros may be omitted.
+ "A String",
+ ],
+ "count": "A String", # The total number of samples in the distribution. Must be >= 0.
+ "sumOfSquaredDeviation": 3.14, # The sum of squared deviations from the mean:
+ # Sum[i=1..count]((x_i - mean)^2)
+ # where each x_i is a sample values. If `count` is zero then this field
+ # must be zero, otherwise validation of the request fails.
+ "linearBuckets": { # Describing buckets with constant width. # Buckets with constant width.
+ "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
+ # the total number of buckets is `num_finite_buckets` + 2.
+ # See comments on `bucket_options` for details.
+ "offset": 3.14, # The i'th linear bucket covers the interval
+ # [offset + (i-1) * width, offset + i * width)
+ # where i ranges from 1 to num_finite_buckets, inclusive.
+ "width": 3.14, # The i'th linear bucket covers the interval
+ # [offset + (i-1) * width, offset + i * width)
+ # where i ranges from 1 to num_finite_buckets, inclusive.
+ # Must be strictly positive.
+ },
+ "maximum": 3.14, # The maximum of the population of values. Ignored if `count` is zero.
+ "exponentialBuckets": { # Describing buckets with exponentially growing width. # Buckets with exponentially growing width.
+ "growthFactor": 3.14, # The i'th exponential bucket covers the interval
+ # [scale * growth_factor^(i-1), scale * growth_factor^i)
+ # where i ranges from 1 to num_finite_buckets inclusive.
+ # Must be larger than 1.0.
+ "scale": 3.14, # The i'th exponential bucket covers the interval
+ # [scale * growth_factor^(i-1), scale * growth_factor^i)
+ # where i ranges from 1 to num_finite_buckets inclusive.
+ # Must be > 0.
+ "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
+ # the total number of buckets is `num_finite_buckets` + 2.
+ # See comments on `bucket_options` for details.
+ },
+ "minimum": 3.14, # The minimum of the population of values. Ignored if `count` is zero.
+ "exemplars": [ # Example points. Must be in increasing order of `value` field.
+ { # Exemplars are example points that may be used to annotate aggregated
+ # distribution values. They are metadata that gives information about a
+ # particular value added to a Distribution bucket, such as a trace ID that
+ # was active when a value was added. They may contain further information,
+ # such as a example values and timestamps, origin, etc.
+ "value": 3.14, # Value of the exemplar point. This value determines to which bucket the
+ # exemplar belongs.
+ "attachments": [ # Contextual information about the example value. Examples are:
+ #
+ # Trace: type.googleapis.com/google.monitoring.v3.SpanContext
+ #
+ # Literal string: type.googleapis.com/google.protobuf.StringValue
+ #
+ # Labels dropped during aggregation:
+ # type.googleapis.com/google.monitoring.v3.DroppedLabels
+ #
+ # There may be only a single attachment of any given message type in a
+ # single exemplar, and this is enforced by the system.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "timestamp": "A String", # The observation (sampling) time of the above value.
+ },
+ ],
+ "mean": 3.14, # The arithmetic mean of the samples in the distribution. If `count` is
+ # zero then this field must be zero.
+ "explicitBuckets": { # Describing buckets with arbitrary user-provided width. # Buckets with arbitrary user-provided width.
+ "bounds": [ # 'bound' is a list of strictly increasing boundaries between
+ # buckets. Note that a list of length N-1 defines N buckets because
+ # of fenceposting. See comments on `bucket_options` for details.
+ #
+ # The i'th finite bucket covers the interval
+ # [bound[i-1], bound[i])
+ # where i ranges from 1 to bound_size() - 1. Note that there are no
+ # finite buckets at all if 'bound' only contains a single element; in
+ # that special case the single bound defines the boundary between the
+ # underflow and overflow buckets.
+ #
+ # bucket number lower bound upper bound
+ # i == 0 (underflow) -inf bound[i]
+ # 0 < i < bound_size() bound[i-1] bound[i]
+ # i == bound_size() (overflow) bound[i-1] +inf
+ 3.14,
+ ],
+ },
+ },
+ "labels": { # The labels describing the metric value.
+ # See comments on google.api.servicecontrol.v1.Operation.labels for
+ # the overriding relationship.
+ # Note that this map must not contain monitored resource labels.
+ "a_key": "A String",
+ },
+ "doubleValue": 3.14, # A double precision floating point value.
+ "endTime": "A String", # The end of the time period over which this metric value's measurement
+ # applies.
+ "boolValue": True or False, # A boolean value.
+ "int64Value": "A String", # A signed 64-bit integer value.
+ "moneyValue": { # Represents an amount of money with its currency type. # A money value.
+ "nanos": 42, # Number of nano (10^-9) units of the amount.
+ # The value must be between -999,999,999 and +999,999,999 inclusive.
+ # If `units` is positive, `nanos` must be positive or zero.
+ # If `units` is zero, `nanos` can be positive, zero, or negative.
+ # If `units` is negative, `nanos` must be negative or zero.
+ # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+ "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+ },
+ "stringValue": "A String", # A text string value.
+ },
+ ],
+ "metricName": "A String", # The metric name defined in the service configuration.
+ },
+ ],
+ "limitExceeded": [ # Quota Metrics that have exceeded quota limits.
+ # For QuotaGroup-based quota, this is QuotaGroup.name
+ # For QuotaLimit-based quota, this is QuotaLimit.name
+ # See: google.api.Quota
+ # Deprecated: Use quota_metrics to get per quota group limit exceeded status.
+ "A String",
+ ],
+ "quotaConsumed": { # Map of quota group name to the actual number of tokens consumed. If the
+ # quota check was not successful, then this will not be populated due to no
+ # quota consumption.
+ #
+ # We are not merging this field with 'quota_metrics' field because of the
+ # complexity of scaling in Chemist client code base. For simplicity, we will
+ # keep this field for Castor (that scales quota usage) and 'quota_metrics'
+ # for SuperQuota (that doesn't scale quota usage).
+ "a_key": 42,
+ },
+ },
+ "serviceConfigId": "A String", # The actual config id used to process the request.
"serviceRolloutId": "A String", # The current service rollout id used to process the request.
"operationId": "A String", # The same operation_id value used in the CheckRequest.
# Used for logging and diagnostics purposes.
@@ -955,10 +1151,10 @@
#
# 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).
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
"message": "A String", # A developer-facing error message, which should be in English. Any
# user-facing error message should be localized and sent in the
# google.rpc.Status.details field, or localized by the client.
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
"details": [ # A list of messages that carry the error details. There is a common set of
# message types for APIs to use.
{
@@ -975,197 +1171,6 @@
"code": "A String", # The error code.
},
],
- "checkInfo": { # Contains additional information about the check operation. # Feedback data returned from the server during processing a Check request.
- "unusedArguments": [ # A list of fields and label keys that are ignored by the server.
- # The client doesn't need to send them for following requests to improve
- # performance and allow better aggregation.
- "A String",
- ],
- "consumerInfo": { # `ConsumerInfo` provides information about the consumer. # Consumer info of this check.
- "type": "A String", # The type of the consumer which should have been defined in
- # [Google Resource Manager](https://cloud.google.com/resource-manager/).
- "projectNumber": "A String", # The Google cloud project number, e.g. 1234567890. A value of 0 indicates
- # no project number is found.
- #
- # NOTE: This field is deprecated after Chemist support flexible consumer
- # id. New code should not depend on this field anymore.
- "consumerNumber": "A String", # The consumer identity number, can be Google cloud project number, folder
- # number or organization number e.g. 1234567890. A value of 0 indicates no
- # consumer number is found.
- },
- },
- "serviceConfigId": "A String", # The actual config id used to process the request.
- "quotaInfo": { # Contains the quota information for a quota check response. # Quota information for the check request associated with this response.
- "limitExceeded": [ # Quota Metrics that have exceeded quota limits.
- # For QuotaGroup-based quota, this is QuotaGroup.name
- # For QuotaLimit-based quota, this is QuotaLimit.name
- # See: google.api.Quota
- # Deprecated: Use quota_metrics to get per quota group limit exceeded status.
- "A String",
- ],
- "quotaConsumed": { # Map of quota group name to the actual number of tokens consumed. If the
- # quota check was not successful, then this will not be populated due to no
- # quota consumption.
- #
- # We are not merging this field with 'quota_metrics' field because of the
- # complexity of scaling in Chemist client code base. For simplicity, we will
- # keep this field for Castor (that scales quota usage) and 'quota_metrics'
- # for SuperQuota (that doesn't scale quota usage).
- "a_key": 42,
- },
- "quotaMetrics": [ # Quota metrics to indicate the usage. Depending on the check request, one or
- # more of the following metrics will be included:
- #
- # 1. For rate quota, per quota group or per quota metric incremental usage
- # will be specified using the following delta metric:
- # "serviceruntime.googleapis.com/api/consumer/quota_used_count"
- #
- # 2. For allocation quota, per quota metric total usage will be specified
- # using the following gauge metric:
- # "serviceruntime.googleapis.com/allocation/consumer/quota_used_count"
- #
- # 3. For both rate quota and allocation quota, the quota limit reached
- # condition will be specified using the following boolean metric:
- # "serviceruntime.googleapis.com/quota/exceeded"
- { # Represents a set of metric values in the same metric.
- # Each metric value in the set should have a unique combination of start time,
- # end time, and label values.
- "metricName": "A String", # The metric name defined in the service configuration.
- "metricValues": [ # The values in this metric.
- { # Represents a single metric value.
- "startTime": "A String", # The start of the time period over which this metric value's measurement
- # applies. The time period has different semantics for different metric
- # types (cumulative, delta, and gauge). See the metric definition
- # documentation in the service configuration for details.
- "moneyValue": { # Represents an amount of money with its currency type. # A money value.
- "nanos": 42, # Number of nano (10^-9) units of the amount.
- # The value must be between -999,999,999 and +999,999,999 inclusive.
- # If `units` is positive, `nanos` must be positive or zero.
- # If `units` is zero, `nanos` can be positive, zero, or negative.
- # If `units` is negative, `nanos` must be negative or zero.
- # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
- "units": "A String", # The whole units of the amount.
- # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- },
- "labels": { # The labels describing the metric value.
- # See comments on google.api.servicecontrol.v1.Operation.labels for
- # the overriding relationship.
- # Note that this map must not contain monitored resource labels.
- "a_key": "A String",
- },
- "stringValue": "A String", # A text string value.
- "doubleValue": 3.14, # A double precision floating point value.
- "int64Value": "A String", # A signed 64-bit integer value.
- "distributionValue": { # Distribution represents a frequency distribution of double-valued sample # A distribution value.
- # points. It contains the size of the population of sample points plus
- # additional optional information:
- #
- # - the arithmetic mean of the samples
- # - the minimum and maximum of the samples
- # - the sum-squared-deviation of the samples, used to compute variance
- # - a histogram of the values of the sample points
- "sumOfSquaredDeviation": 3.14, # The sum of squared deviations from the mean:
- # Sum[i=1..count]((x_i - mean)^2)
- # where each x_i is a sample values. If `count` is zero then this field
- # must be zero, otherwise validation of the request fails.
- "exemplars": [ # Example points. Must be in increasing order of `value` field.
- { # Exemplars are example points that may be used to annotate aggregated
- # distribution values. They are metadata that gives information about a
- # particular value added to a Distribution bucket, such as a trace ID that
- # was active when a value was added. They may contain further information,
- # such as a example values and timestamps, origin, etc.
- "value": 3.14, # Value of the exemplar point. This value determines to which bucket the
- # exemplar belongs.
- "timestamp": "A String", # The observation (sampling) time of the above value.
- "attachments": [ # Contextual information about the example value. Examples are:
- #
- # Trace: type.googleapis.com/google.monitoring.v3.SpanContext
- #
- # Literal string: type.googleapis.com/google.protobuf.StringValue
- #
- # Labels dropped during aggregation:
- # type.googleapis.com/google.monitoring.v3.DroppedLabels
- #
- # There may be only a single attachment of any given message type in a
- # single exemplar, and this is enforced by the system.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
- },
- ],
- "exponentialBuckets": { # Describing buckets with exponentially growing width. # Buckets with exponentially growing width.
- "growthFactor": 3.14, # The i'th exponential bucket covers the interval
- # [scale * growth_factor^(i-1), scale * growth_factor^i)
- # where i ranges from 1 to num_finite_buckets inclusive.
- # Must be larger than 1.0.
- "scale": 3.14, # The i'th exponential bucket covers the interval
- # [scale * growth_factor^(i-1), scale * growth_factor^i)
- # where i ranges from 1 to num_finite_buckets inclusive.
- # Must be > 0.
- "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
- # the total number of buckets is `num_finite_buckets` + 2.
- # See comments on `bucket_options` for details.
- },
- "minimum": 3.14, # The minimum of the population of values. Ignored if `count` is zero.
- "linearBuckets": { # Describing buckets with constant width. # Buckets with constant width.
- "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
- # the total number of buckets is `num_finite_buckets` + 2.
- # See comments on `bucket_options` for details.
- "width": 3.14, # The i'th linear bucket covers the interval
- # [offset + (i-1) * width, offset + i * width)
- # where i ranges from 1 to num_finite_buckets, inclusive.
- # Must be strictly positive.
- "offset": 3.14, # The i'th linear bucket covers the interval
- # [offset + (i-1) * width, offset + i * width)
- # where i ranges from 1 to num_finite_buckets, inclusive.
- },
- "mean": 3.14, # The arithmetic mean of the samples in the distribution. If `count` is
- # zero then this field must be zero.
- "count": "A String", # The total number of samples in the distribution. Must be >= 0.
- "bucketCounts": [ # The number of samples in each histogram bucket. `bucket_counts` are
- # optional. If present, they must sum to the `count` value.
- #
- # The buckets are defined below in `bucket_option`. There are N buckets.
- # `bucket_counts[0]` is the number of samples in the underflow bucket.
- # `bucket_counts[1]` to `bucket_counts[N-1]` are the numbers of samples
- # in each of the finite buckets. And `bucket_counts[N] is the number
- # of samples in the overflow bucket. See the comments of `bucket_option`
- # below for more details.
- #
- # Any suffix of trailing zeros may be omitted.
- "A String",
- ],
- "explicitBuckets": { # Describing buckets with arbitrary user-provided width. # Buckets with arbitrary user-provided width.
- "bounds": [ # 'bound' is a list of strictly increasing boundaries between
- # buckets. Note that a list of length N-1 defines N buckets because
- # of fenceposting. See comments on `bucket_options` for details.
- #
- # The i'th finite bucket covers the interval
- # [bound[i-1], bound[i])
- # where i ranges from 1 to bound_size() - 1. Note that there are no
- # finite buckets at all if 'bound' only contains a single element; in
- # that special case the single bound defines the boundary between the
- # underflow and overflow buckets.
- #
- # bucket number lower bound upper bound
- # i == 0 (underflow) -inf bound[i]
- # 0 < i < bound_size() bound[i-1] bound[i]
- # i == bound_size() (overflow) bound[i-1] +inf
- 3.14,
- ],
- },
- "maximum": 3.14, # The maximum of the population of values. Ignored if `count` is zero.
- },
- "boolValue": True or False, # A boolean value.
- "endTime": "A String", # The end of the time period over which this metric value's measurement
- # applies.
- },
- ],
- },
- ],
- },
}</pre>
</div>
@@ -1209,21 +1214,108 @@
# however the ReportRequest size should be no larger than 1MB. See
# ReportResponse.report_errors for partial failure behavior.
{ # Represents information regarding an operation.
- "operationId": "A String", # Identity of the operation. This must be unique within the scope of the
- # service that generated the operation. If the service calls
- # Check() and Report() on the same operation, the two calls should carry
- # the same id.
- #
- # UUID version 4 is recommended, though not required.
- # In scenarios where an operation is computed from existing information
- # and an idempotent id is desirable for deduplication purpose, UUID version 5
- # is recommended. See RFC 4122 for details.
- "operationName": "A String", # Fully qualified name of the operation. Reserved for future use.
- "endTime": "A String", # End time of the operation.
- # Required when the operation is used in ServiceController.Report,
- # but optional when the operation is used in ServiceController.Check.
"startTime": "A String", # Required. Start time of the operation.
- "importance": "A String", # DO NOT USE. This is an experimental field.
+ "traceSpans": [ # Unimplemented. A list of Cloud Trace spans. The span names shall contain
+ # the id of the destination project which can be either the produce or the
+ # consumer project.
+ { # A span represents a single operation within a trace. Spans can be
+ # nested to form a trace tree. Often, a trace contains a root span
+ # that describes the end-to-end latency, and one or more subspans for
+ # its sub-operations. A trace can also contain multiple root spans,
+ # or none at all. Spans do not need to be contiguous&mdash;there may be
+ # gaps or overlaps between spans in a trace.
+ "spanKind": "A String", # Distinguishes between spans generated in a particular context. For example,
+ # two spans with the same name may be distinguished using `CLIENT` (caller)
+ # and `SERVER` (callee) to identify an RPC call.
+ "sameProcessAsParentSpan": True or False, # (Optional) Set this parameter to indicate whether this span is in
+ # the same process as its parent. If you do not set this parameter,
+ # Stackdriver Trace is unable to take advantage of this helpful
+ # information.
+ "childSpanCount": 42, # An optional number of child spans that were generated while this span
+ # was active. If set, allows implementation to detect missing child spans.
+ "startTime": "A String", # The start time of the span. On the client side, this is the time kept by
+ # the local machine where the span execution starts. On the server side, this
+ # is the time when the server's application handler starts running.
+ "displayName": { # Represents a string that might be shortened to a specified length. # A description of the span's operation (up to 128 bytes).
+ # Stackdriver Trace displays the description in the
+ # Google Cloud Platform Console.
+ # For example, the display name can be a qualified method name or a file name
+ # and a line number where the operation is called. A best practice is to use
+ # the same display name within an application and at the same call point.
+ # This makes it easier to correlate spans in different traces.
+ "value": "A String", # The shortened string. For example, if the original string is 500
+ # bytes long and the limit of the string is 128 bytes, then
+ # `value` contains the first 128 bytes of the 500-byte string.
+ #
+ # Truncation always happens on a UTF8 character boundary. If there
+ # are multi-byte characters in the string, then the length of the
+ # shortened string might be less than the size limit.
+ "truncatedByteCount": 42, # The number of bytes removed from the original string. If this
+ # value is 0, then the string was not shortened.
+ },
+ "endTime": "A String", # The end time of the span. On the client side, this is the time kept by
+ # the local machine where the span execution ends. On the server side, this
+ # is the time when the server application handler stops running.
+ "attributes": { # A set of attributes, each in the format `[KEY]:[VALUE]`. # A set of attributes on the span. You can have up to 32 attributes per
+ # span.
+ "attributeMap": { # The set of attributes. Each attribute's key can be up to 128 bytes
+ # long. The value can be a string up to 256 bytes, a signed 64-bit integer,
+ # or the Boolean values `true` and `false`. For example:
+ #
+ # "/instance_id": "my-instance"
+ # "/http/user_agent": ""
+ # "/http/request_bytes": 300
+ # "abc.com/myattribute": true
+ "a_key": { # The allowed types for [VALUE] in a `[KEY]:[VALUE]` attribute.
+ "stringValue": { # Represents a string that might be shortened to a specified length. # A string up to 256 bytes long.
+ "value": "A String", # The shortened string. For example, if the original string is 500
+ # bytes long and the limit of the string is 128 bytes, then
+ # `value` contains the first 128 bytes of the 500-byte string.
+ #
+ # Truncation always happens on a UTF8 character boundary. If there
+ # are multi-byte characters in the string, then the length of the
+ # shortened string might be less than the size limit.
+ "truncatedByteCount": 42, # The number of bytes removed from the original string. If this
+ # value is 0, then the string was not shortened.
+ },
+ "intValue": "A String", # A 64-bit signed integer.
+ "boolValue": True or False, # A Boolean value represented by `true` or `false`.
+ },
+ },
+ "droppedAttributesCount": 42, # The number of attributes that were discarded. Attributes can be discarded
+ # because their keys are too long or because there are too many attributes.
+ # If this value is 0 then all attributes are valid.
+ },
+ "parentSpanId": "A String", # The [SPAN_ID] of this span's parent span. If this is a root span,
+ # then this field must be empty.
+ "name": "A String", # The resource name of the span in the following format:
+ #
+ # projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/SPAN_ID is a unique identifier for a trace within a project;
+ # it is a 32-character hexadecimal encoding of a 16-byte array.
+ #
+ # [SPAN_ID] is a unique identifier for a span within a trace; it
+ # is a 16-character hexadecimal encoding of an 8-byte array.
+ "spanId": "A String", # The [SPAN_ID] portion of the span's resource name.
+ "status": { # The `Status` type defines a logical error model that is suitable for # An optional final status for this span.
+ # 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).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ },
+ },
+ ],
"labels": { # Labels describing the operation. Only the following labels are allowed:
#
# - Labels describing monitored resources as defined in
@@ -1242,116 +1334,15 @@
# Kubernetes Engine.
"a_key": "A String",
},
- "resources": [ # The resources that are involved in the operation.
- # The maximum supported number of entries in this field is 100.
- { # Describes a resource associated with this operation.
- "resourceName": "A String", # Name of the resource. This is used for auditing purposes.
- "resourceLocation": "A String", # The location of the resource. If not empty, the resource will be checked
- # against location policy. The value must be a valid zone, region or
- # multiregion. For example: "europe-west4" or "northamerica-northeast1-a"
- "resourceContainer": "A String", # The identifier of the parent of this resource instance.
- # Must be in one of the following formats:
- # - “projects/<project-id or project-number>”
- # - “folders/<folder-id>”
- # - “organizations/<organization-id>”
- },
- ],
- "logEntries": [ # Represents information to be logged.
- { # An individual log entry.
- "httpRequest": { # A common proto for logging HTTP requests. Only contains semantics # Optional. Information about the HTTP request associated with this
- # log entry, if applicable.
- # defined by the HTTP specification. Product-specific logging
- # information MUST be defined in a separate message.
- "referer": "A String", # The referer URL of the request, as defined in
- # [HTTP/1.1 Header Field
- # Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
- "latency": "A String", # The request processing latency on the server, from the time the request was
- # received until the response was sent.
- "userAgent": "A String", # The user agent sent by the client. Example:
- # `"Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET
- # CLR 1.0.3705)"`.
- "cacheFillBytes": "A String", # The number of HTTP response bytes inserted into cache. Set only when a
- # cache fill was attempted.
- "requestMethod": "A String", # The request method. Examples: `"GET"`, `"HEAD"`, `"PUT"`, `"POST"`.
- "requestSize": "A String", # The size of the HTTP request message in bytes, including the request
- # headers and the request body.
- "responseSize": "A String", # The size of the HTTP response message sent back to the client, in bytes,
- # including the response headers and the response body.
- "protocol": "A String", # Protocol used for the request. Examples: "HTTP/1.1", "HTTP/2", "websocket"
- "requestUrl": "A String", # The scheme (http, https), the host name, the path, and the query
- # portion of the URL that was requested.
- # Example: `"http://example.com/some/info?color=red"`.
- "remoteIp": "A String", # The IP address (IPv4 or IPv6) of the client that issued the HTTP
- # request. Examples: `"192.168.1.1"`, `"FE80::0202:B3FF:FE1E:8329"`.
- "serverIp": "A String", # The IP address (IPv4 or IPv6) of the origin server that the request was
- # sent to.
- "cacheLookup": True or False, # Whether or not a cache lookup was attempted.
- "cacheHit": True or False, # Whether or not an entity was served from cache
- # (with or without validation).
- "cacheValidatedWithOriginServer": True or False, # Whether or not the response was validated with the origin server before
- # being served from cache. This field is only meaningful if `cache_hit` is
- # True.
- "status": 42, # The response code indicating the status of the response.
- # Examples: 200, 404.
- },
- "operation": { # Additional information about a potentially long-running operation with which # Optional. Information about an operation associated with the log entry, if
- # applicable.
- # a log entry is associated.
- "id": "A String", # Optional. An arbitrary operation identifier. Log entries with the
- # same identifier are assumed to be part of the same operation.
- "producer": "A String", # Optional. An arbitrary producer identifier. The combination of
- # `id` and `producer` must be globally unique. Examples for `producer`:
- # `"MyDivision.MyBigCompany.com"`, `"github.com/MyProject/MyApplication"`.
- "first": True or False, # Optional. Set this to True if this is the first log entry in the operation.
- "last": True or False, # Optional. Set this to True if this is the last log entry in the operation.
- },
- "name": "A String", # Required. The log to which this log entry belongs. Examples: `"syslog"`,
- # `"book_log"`.
- "insertId": "A String", # A unique ID for the log entry used for deduplication. If omitted,
- # the implementation will generate one based on operation_id.
- "textPayload": "A String", # The log entry payload, represented as a Unicode string (UTF-8).
- "protoPayload": { # The log entry payload, represented as a protocol buffer that is
- # expressed as a JSON object. The only accepted type currently is
- # AuditLog.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- "labels": { # A set of user-defined (key, value) data that provides additional
- # information about the log entry.
- "a_key": "A String",
- },
- "trace": "A String", # Optional. Resource name of the trace associated with the log entry, if any.
- # If this field contains a relative resource name, you can assume the name is
- # relative to `//tracing.googleapis.com`. Example:
- # `projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824`
- "severity": "A String", # The severity of the log entry. The default value is
- # `LogSeverity.DEFAULT`.
- "sourceLocation": { # Additional information about the source code location that produced the log # Optional. Source code location information associated with the log entry,
- # if any.
- # entry.
- "line": "A String", # Optional. Line within the source file. 1-based; 0 indicates no line number
- # available.
- "file": "A String", # Optional. Source file name. Depending on the runtime environment, this
- # might be a simple name or a fully-qualified name.
- "function": "A String", # Optional. Human-readable name of the function or method being invoked, with
- # optional context such as the class or package name. This information may be
- # used in contexts such as the logs viewer, where a file and line number are
- # less meaningful. The format can vary by language. For example:
- # `qual.if.ied.Class.method` (Java), `dir/package.func` (Go), `function`
- # (Python).
- },
- "structPayload": { # The log entry payload, represented as a structure that
- # is expressed as a JSON object.
- "a_key": "", # Properties of the object.
- },
- "timestamp": "A String", # The time the event described by the log entry occurred. If
- # omitted, defaults to operation start time.
- },
- ],
- "userLabels": { # User defined labels for the resource that this operation is associated
- # with. Only a combination of 1000 user labels per consumer project are
- # allowed.
- "a_key": "A String",
- },
+ "operationId": "A String", # Identity of the operation. This must be unique within the scope of the
+ # service that generated the operation. If the service calls
+ # Check() and Report() on the same operation, the two calls should carry
+ # the same id.
+ #
+ # UUID version 4 is recommended, though not required.
+ # In scenarios where an operation is computed from existing information
+ # and an idempotent id is desirable for deduplication purpose, UUID version 5
+ # is recommended. See RFC 4122 for details.
"metricValueSets": [ # Represents information about this operation. Each MetricValueSet
# corresponds to a metric defined in the service configuration.
# The data type used in the MetricValueSet must agree with
@@ -1365,33 +1356,12 @@
{ # Represents a set of metric values in the same metric.
# Each metric value in the set should have a unique combination of start time,
# end time, and label values.
- "metricName": "A String", # The metric name defined in the service configuration.
"metricValues": [ # The values in this metric.
{ # Represents a single metric value.
"startTime": "A String", # The start of the time period over which this metric value's measurement
# applies. The time period has different semantics for different metric
# types (cumulative, delta, and gauge). See the metric definition
# documentation in the service configuration for details.
- "moneyValue": { # Represents an amount of money with its currency type. # A money value.
- "nanos": 42, # Number of nano (10^-9) units of the amount.
- # The value must be between -999,999,999 and +999,999,999 inclusive.
- # If `units` is positive, `nanos` must be positive or zero.
- # If `units` is zero, `nanos` can be positive, zero, or negative.
- # If `units` is negative, `nanos` must be negative or zero.
- # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
- "units": "A String", # The whole units of the amount.
- # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- },
- "labels": { # The labels describing the metric value.
- # See comments on google.api.servicecontrol.v1.Operation.labels for
- # the overriding relationship.
- # Note that this map must not contain monitored resource labels.
- "a_key": "A String",
- },
- "stringValue": "A String", # A text string value.
- "doubleValue": 3.14, # A double precision floating point value.
- "int64Value": "A String", # A signed 64-bit integer value.
"distributionValue": { # Distribution represents a frequency distribution of double-valued sample # A distribution value.
# points. It contains the size of the population of sample points plus
# additional optional information:
@@ -1400,10 +1370,51 @@
# - the minimum and maximum of the samples
# - the sum-squared-deviation of the samples, used to compute variance
# - a histogram of the values of the sample points
+ "bucketCounts": [ # The number of samples in each histogram bucket. `bucket_counts` are
+ # optional. If present, they must sum to the `count` value.
+ #
+ # The buckets are defined below in `bucket_option`. There are N buckets.
+ # `bucket_counts[0]` is the number of samples in the underflow bucket.
+ # `bucket_counts[1]` to `bucket_counts[N-1]` are the numbers of samples
+ # in each of the finite buckets. And `bucket_counts[N] is the number
+ # of samples in the overflow bucket. See the comments of `bucket_option`
+ # below for more details.
+ #
+ # Any suffix of trailing zeros may be omitted.
+ "A String",
+ ],
+ "count": "A String", # The total number of samples in the distribution. Must be >= 0.
"sumOfSquaredDeviation": 3.14, # The sum of squared deviations from the mean:
# Sum[i=1..count]((x_i - mean)^2)
# where each x_i is a sample values. If `count` is zero then this field
# must be zero, otherwise validation of the request fails.
+ "linearBuckets": { # Describing buckets with constant width. # Buckets with constant width.
+ "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
+ # the total number of buckets is `num_finite_buckets` + 2.
+ # See comments on `bucket_options` for details.
+ "offset": 3.14, # The i'th linear bucket covers the interval
+ # [offset + (i-1) * width, offset + i * width)
+ # where i ranges from 1 to num_finite_buckets, inclusive.
+ "width": 3.14, # The i'th linear bucket covers the interval
+ # [offset + (i-1) * width, offset + i * width)
+ # where i ranges from 1 to num_finite_buckets, inclusive.
+ # Must be strictly positive.
+ },
+ "maximum": 3.14, # The maximum of the population of values. Ignored if `count` is zero.
+ "exponentialBuckets": { # Describing buckets with exponentially growing width. # Buckets with exponentially growing width.
+ "growthFactor": 3.14, # The i'th exponential bucket covers the interval
+ # [scale * growth_factor^(i-1), scale * growth_factor^i)
+ # where i ranges from 1 to num_finite_buckets inclusive.
+ # Must be larger than 1.0.
+ "scale": 3.14, # The i'th exponential bucket covers the interval
+ # [scale * growth_factor^(i-1), scale * growth_factor^i)
+ # where i ranges from 1 to num_finite_buckets inclusive.
+ # Must be > 0.
+ "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
+ # the total number of buckets is `num_finite_buckets` + 2.
+ # See comments on `bucket_options` for details.
+ },
+ "minimum": 3.14, # The minimum of the population of values. Ignored if `count` is zero.
"exemplars": [ # Example points. Must be in increasing order of `value` field.
{ # Exemplars are example points that may be used to annotate aggregated
# distribution values. They are metadata that gives information about a
@@ -1412,7 +1423,6 @@
# such as a example values and timestamps, origin, etc.
"value": 3.14, # Value of the exemplar point. This value determines to which bucket the
# exemplar belongs.
- "timestamp": "A String", # The observation (sampling) time of the above value.
"attachments": [ # Contextual information about the example value. Examples are:
#
# Trace: type.googleapis.com/google.monitoring.v3.SpanContext
@@ -1428,50 +1438,11 @@
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
+ "timestamp": "A String", # The observation (sampling) time of the above value.
},
],
- "exponentialBuckets": { # Describing buckets with exponentially growing width. # Buckets with exponentially growing width.
- "growthFactor": 3.14, # The i'th exponential bucket covers the interval
- # [scale * growth_factor^(i-1), scale * growth_factor^i)
- # where i ranges from 1 to num_finite_buckets inclusive.
- # Must be larger than 1.0.
- "scale": 3.14, # The i'th exponential bucket covers the interval
- # [scale * growth_factor^(i-1), scale * growth_factor^i)
- # where i ranges from 1 to num_finite_buckets inclusive.
- # Must be > 0.
- "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
- # the total number of buckets is `num_finite_buckets` + 2.
- # See comments on `bucket_options` for details.
- },
- "minimum": 3.14, # The minimum of the population of values. Ignored if `count` is zero.
- "linearBuckets": { # Describing buckets with constant width. # Buckets with constant width.
- "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
- # the total number of buckets is `num_finite_buckets` + 2.
- # See comments on `bucket_options` for details.
- "width": 3.14, # The i'th linear bucket covers the interval
- # [offset + (i-1) * width, offset + i * width)
- # where i ranges from 1 to num_finite_buckets, inclusive.
- # Must be strictly positive.
- "offset": 3.14, # The i'th linear bucket covers the interval
- # [offset + (i-1) * width, offset + i * width)
- # where i ranges from 1 to num_finite_buckets, inclusive.
- },
"mean": 3.14, # The arithmetic mean of the samples in the distribution. If `count` is
# zero then this field must be zero.
- "count": "A String", # The total number of samples in the distribution. Must be >= 0.
- "bucketCounts": [ # The number of samples in each histogram bucket. `bucket_counts` are
- # optional. If present, they must sum to the `count` value.
- #
- # The buckets are defined below in `bucket_option`. There are N buckets.
- # `bucket_counts[0]` is the number of samples in the underflow bucket.
- # `bucket_counts[1]` to `bucket_counts[N-1]` are the numbers of samples
- # in each of the finite buckets. And `bucket_counts[N] is the number
- # of samples in the overflow bucket. See the comments of `bucket_option`
- # below for more details.
- #
- # Any suffix of trailing zeros may be omitted.
- "A String",
- ],
"explicitBuckets": { # Describing buckets with arbitrary user-provided width. # Buckets with arbitrary user-provided width.
"bounds": [ # 'bound' is a list of strictly increasing boundaries between
# buckets. Note that a list of length N-1 defines N buckets because
@@ -1491,121 +1462,160 @@
3.14,
],
},
- "maximum": 3.14, # The maximum of the population of values. Ignored if `count` is zero.
},
- "boolValue": True or False, # A boolean value.
+ "labels": { # The labels describing the metric value.
+ # See comments on google.api.servicecontrol.v1.Operation.labels for
+ # the overriding relationship.
+ # Note that this map must not contain monitored resource labels.
+ "a_key": "A String",
+ },
+ "doubleValue": 3.14, # A double precision floating point value.
"endTime": "A String", # The end of the time period over which this metric value's measurement
# applies.
+ "boolValue": True or False, # A boolean value.
+ "int64Value": "A String", # A signed 64-bit integer value.
+ "moneyValue": { # Represents an amount of money with its currency type. # A money value.
+ "nanos": 42, # Number of nano (10^-9) units of the amount.
+ # The value must be between -999,999,999 and +999,999,999 inclusive.
+ # If `units` is positive, `nanos` must be positive or zero.
+ # If `units` is zero, `nanos` can be positive, zero, or negative.
+ # If `units` is negative, `nanos` must be negative or zero.
+ # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+ "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+ },
+ "stringValue": "A String", # A text string value.
},
],
+ "metricName": "A String", # The metric name defined in the service configuration.
},
],
- "traceSpans": [ # Unimplemented. A list of Cloud Trace spans. The span names shall contain
- # the id of the destination project which can be either the produce or the
- # consumer project.
- { # A span represents a single operation within a trace. Spans can be
- # nested to form a trace tree. Often, a trace contains a root span
- # that describes the end-to-end latency, and one or more subspans for
- # its sub-operations. A trace can also contain multiple root spans,
- # or none at all. Spans do not need to be contiguous&mdash;there may be
- # gaps or overlaps between spans in a trace.
- "childSpanCount": 42, # An optional number of child spans that were generated while this span
- # was active. If set, allows implementation to detect missing child spans.
- "sameProcessAsParentSpan": True or False, # (Optional) Set this parameter to indicate whether this span is in
- # the same process as its parent. If you do not set this parameter,
- # Stackdriver Trace is unable to take advantage of this helpful
- # information.
- "status": { # The `Status` type defines a logical error model that is suitable for # An optional final status for this span.
- # 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).
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
+ "userLabels": { # User defined labels for the resource that this operation is associated
+ # with. Only a combination of 1000 user labels per consumer project are
+ # allowed.
+ "a_key": "A String",
+ },
+ "logEntries": [ # Represents information to be logged.
+ { # An individual log entry.
+ "textPayload": "A String", # The log entry payload, represented as a Unicode string (UTF-8).
+ "sourceLocation": { # Additional information about the source code location that produced the log # Optional. Source code location information associated with the log entry,
+ # if any.
+ # entry.
+ "function": "A String", # Optional. Human-readable name of the function or method being invoked, with
+ # optional context such as the class or package name. This information may be
+ # used in contexts such as the logs viewer, where a file and line number are
+ # less meaningful. The format can vary by language. For example:
+ # `qual.if.ied.Class.method` (Java), `dir/package.func` (Go), `function`
+ # (Python).
+ "line": "A String", # Optional. Line within the source file. 1-based; 0 indicates no line number
+ # available.
+ "file": "A String", # Optional. Source file name. Depending on the runtime environment, this
+ # might be a simple name or a fully-qualified name.
},
- "name": "A String", # The resource name of the span in the following format:
- #
- # projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/SPAN_ID is a unique identifier for a trace within a project;
- # it is a 32-character hexadecimal encoding of a 16-byte array.
- #
- # [SPAN_ID] is a unique identifier for a span within a trace; it
- # is a 16-character hexadecimal encoding of an 8-byte array.
- "attributes": { # A set of attributes, each in the format `[KEY]:[VALUE]`. # A set of attributes on the span. You can have up to 32 attributes per
- # span.
- "droppedAttributesCount": 42, # The number of attributes that were discarded. Attributes can be discarded
- # because their keys are too long or because there are too many attributes.
- # If this value is 0 then all attributes are valid.
- "attributeMap": { # The set of attributes. Each attribute's key can be up to 128 bytes
- # long. The value can be a string up to 256 bytes, a signed 64-bit integer,
- # or the Boolean values `true` and `false`. For example:
- #
- # "/instance_id": "my-instance"
- # "/http/user_agent": ""
- # "/http/request_bytes": 300
- # "abc.com/myattribute": true
- "a_key": { # The allowed types for [VALUE] in a `[KEY]:[VALUE]` attribute.
- "intValue": "A String", # A 64-bit signed integer.
- "stringValue": { # Represents a string that might be shortened to a specified length. # A string up to 256 bytes long.
- "truncatedByteCount": 42, # The number of bytes removed from the original string. If this
- # value is 0, then the string was not shortened.
- "value": "A String", # The shortened string. For example, if the original string is 500
- # bytes long and the limit of the string is 128 bytes, then
- # `value` contains the first 128 bytes of the 500-byte string.
- #
- # Truncation always happens on a UTF8 character boundary. If there
- # are multi-byte characters in the string, then the length of the
- # shortened string might be less than the size limit.
- },
- "boolValue": True or False, # A Boolean value represented by `true` or `false`.
- },
- },
+ "severity": "A String", # The severity of the log entry. The default value is
+ # `LogSeverity.DEFAULT`.
+ "structPayload": { # The log entry payload, represented as a structure that
+ # is expressed as a JSON object.
+ "a_key": "", # Properties of the object.
},
- "spanId": "A String", # The [SPAN_ID] portion of the span's resource name.
- "parentSpanId": "A String", # The [SPAN_ID] of this span's parent span. If this is a root span,
- # then this field must be empty.
- "endTime": "A String", # The end time of the span. On the client side, this is the time kept by
- # the local machine where the span execution ends. On the server side, this
- # is the time when the server application handler stops running.
- "spanKind": "A String", # Distinguishes between spans generated in a particular context. For example,
- # two spans with the same name may be distinguished using `CLIENT` (caller)
- # and `SERVER` (callee) to identify an RPC call.
- "startTime": "A String", # The start time of the span. On the client side, this is the time kept by
- # the local machine where the span execution starts. On the server side, this
- # is the time when the server's application handler starts running.
- "displayName": { # Represents a string that might be shortened to a specified length. # A description of the span's operation (up to 128 bytes).
- # Stackdriver Trace displays the description in the
- # Google Cloud Platform Console.
- # For example, the display name can be a qualified method name or a file name
- # and a line number where the operation is called. A best practice is to use
- # the same display name within an application and at the same call point.
- # This makes it easier to correlate spans in different traces.
- "truncatedByteCount": 42, # The number of bytes removed from the original string. If this
- # value is 0, then the string was not shortened.
- "value": "A String", # The shortened string. For example, if the original string is 500
- # bytes long and the limit of the string is 128 bytes, then
- # `value` contains the first 128 bytes of the 500-byte string.
- #
- # Truncation always happens on a UTF8 character boundary. If there
- # are multi-byte characters in the string, then the length of the
- # shortened string might be less than the size limit.
+ "labels": { # A set of user-defined (key, value) data that provides additional
+ # information about the log entry.
+ "a_key": "A String",
},
+ "protoPayload": { # The log entry payload, represented as a protocol buffer that is
+ # expressed as a JSON object. The only accepted type currently is
+ # AuditLog.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "httpRequest": { # A common proto for logging HTTP requests. Only contains semantics # Optional. Information about the HTTP request associated with this
+ # log entry, if applicable.
+ # defined by the HTTP specification. Product-specific logging
+ # information MUST be defined in a separate message.
+ "protocol": "A String", # Protocol used for the request. Examples: "HTTP/1.1", "HTTP/2", "websocket"
+ "cacheValidatedWithOriginServer": True or False, # Whether or not the response was validated with the origin server before
+ # being served from cache. This field is only meaningful if `cache_hit` is
+ # True.
+ "cacheFillBytes": "A String", # The number of HTTP response bytes inserted into cache. Set only when a
+ # cache fill was attempted.
+ "requestSize": "A String", # The size of the HTTP request message in bytes, including the request
+ # headers and the request body.
+ "responseSize": "A String", # The size of the HTTP response message sent back to the client, in bytes,
+ # including the response headers and the response body.
+ "serverIp": "A String", # The IP address (IPv4 or IPv6) of the origin server that the request was
+ # sent to.
+ "referer": "A String", # The referer URL of the request, as defined in
+ # [HTTP/1.1 Header Field
+ # Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
+ "cacheHit": True or False, # Whether or not an entity was served from cache
+ # (with or without validation).
+ "latency": "A String", # The request processing latency on the server, from the time the request was
+ # received until the response was sent.
+ "requestUrl": "A String", # The scheme (http, https), the host name, the path, and the query
+ # portion of the URL that was requested.
+ # Example: `"http://example.com/some/info?color=red"`.
+ "cacheLookup": True or False, # Whether or not a cache lookup was attempted.
+ "requestMethod": "A String", # The request method. Examples: `"GET"`, `"HEAD"`, `"PUT"`, `"POST"`.
+ "remoteIp": "A String", # The IP address (IPv4 or IPv6) of the client that issued the HTTP
+ # request. Examples: `"192.168.1.1"`, `"FE80::0202:B3FF:FE1E:8329"`.
+ "userAgent": "A String", # The user agent sent by the client. Example:
+ # `"Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET
+ # CLR 1.0.3705)"`.
+ "status": 42, # The response code indicating the status of the response.
+ # Examples: 200, 404.
+ },
+ "operation": { # Additional information about a potentially long-running operation with which # Optional. Information about an operation associated with the log entry, if
+ # applicable.
+ # a log entry is associated.
+ "first": True or False, # Optional. Set this to True if this is the first log entry in the operation.
+ "id": "A String", # Optional. An arbitrary operation identifier. Log entries with the
+ # same identifier are assumed to be part of the same operation.
+ "producer": "A String", # Optional. An arbitrary producer identifier. The combination of
+ # `id` and `producer` must be globally unique. Examples for `producer`:
+ # `"MyDivision.MyBigCompany.com"`, `"github.com/MyProject/MyApplication"`.
+ "last": True or False, # Optional. Set this to True if this is the last log entry in the operation.
+ },
+ "name": "A String", # Required. The log to which this log entry belongs. Examples: `"syslog"`,
+ # `"book_log"`.
+ "trace": "A String", # Optional. Resource name of the trace associated with the log entry, if any.
+ # If this field contains a relative resource name, you can assume the name is
+ # relative to `//tracing.googleapis.com`. Example:
+ # `projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824`
+ "timestamp": "A String", # The time the event described by the log entry occurred. If
+ # omitted, defaults to operation start time.
+ "insertId": "A String", # A unique ID for the log entry used for deduplication. If omitted,
+ # the implementation will generate one based on operation_id.
},
],
+ "importance": "A String", # DO NOT USE. This is an experimental field.
"quotaProperties": { # Represents the properties needed for quota operations. # Represents the properties needed for quota check. Applicable only if this
# operation is for a quota check request. If this is not specified, no quota
# check will be performed.
"quotaMode": "A String", # Quota mode for this operation.
},
+ "operationName": "A String", # Fully qualified name of the operation. Reserved for future use.
+ "resources": [ # The resources that are involved in the operation.
+ # The maximum supported number of entries in this field is 100.
+ { # Describes a resource associated with this operation.
+ "resourceContainer": "A String", # The identifier of the parent of this resource instance.
+ # Must be in one of the following formats:
+ # - “projects/<project-id or project-number>”
+ # - “folders/<folder-id>”
+ # - “organizations/<organization-id>”
+ "resourceName": "A String", # Name of the resource. This is used for auditing purposes.
+ "resourceLocation": "A String", # The location of the resource. If not empty, the resource will be checked
+ # against location policy. The value must be a valid zone, region or
+ # multiregion. For example: "europe-west4" or "northamerica-northeast1-a"
+ },
+ ],
+ "endTime": "A String", # End time of the operation.
+ # Required when the operation is used in ServiceController.Report,
+ # but optional when the operation is used in ServiceController.Check.
+ "extensions": [ # Unimplemented.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
"consumerId": "A String", # Identity of the consumer who is using the service.
# This field should be filled in for the operations initiated by a
# consumer, but not for service-initiated operations that are
@@ -1636,7 +1646,6 @@
An object of the form:
{ # Response message for the Report method.
- "serviceRolloutId": "A String", # The current service rollout id used to process the request.
"reportInfos": [ # Quota usage for each quota release `Operation` request.
#
# Fully or partially failed quota release request may or may not be present
@@ -1646,25 +1655,7 @@
#
# If there is no quota release request, report_quota_info will be empty.
{ # Contains additional info about the report operation.
- "operationId": "A String", # The Operation.operation_id value from the request.
"quotaInfo": { # Contains the quota information for a quota check response. # Quota usage info when processing the `Operation`.
- "limitExceeded": [ # Quota Metrics that have exceeded quota limits.
- # For QuotaGroup-based quota, this is QuotaGroup.name
- # For QuotaLimit-based quota, this is QuotaLimit.name
- # See: google.api.Quota
- # Deprecated: Use quota_metrics to get per quota group limit exceeded status.
- "A String",
- ],
- "quotaConsumed": { # Map of quota group name to the actual number of tokens consumed. If the
- # quota check was not successful, then this will not be populated due to no
- # quota consumption.
- #
- # We are not merging this field with 'quota_metrics' field because of the
- # complexity of scaling in Chemist client code base. For simplicity, we will
- # keep this field for Castor (that scales quota usage) and 'quota_metrics'
- # for SuperQuota (that doesn't scale quota usage).
- "a_key": 42,
- },
"quotaMetrics": [ # Quota metrics to indicate the usage. Depending on the check request, one or
# more of the following metrics will be included:
#
@@ -1682,33 +1673,12 @@
{ # Represents a set of metric values in the same metric.
# Each metric value in the set should have a unique combination of start time,
# end time, and label values.
- "metricName": "A String", # The metric name defined in the service configuration.
"metricValues": [ # The values in this metric.
{ # Represents a single metric value.
"startTime": "A String", # The start of the time period over which this metric value's measurement
# applies. The time period has different semantics for different metric
# types (cumulative, delta, and gauge). See the metric definition
# documentation in the service configuration for details.
- "moneyValue": { # Represents an amount of money with its currency type. # A money value.
- "nanos": 42, # Number of nano (10^-9) units of the amount.
- # The value must be between -999,999,999 and +999,999,999 inclusive.
- # If `units` is positive, `nanos` must be positive or zero.
- # If `units` is zero, `nanos` can be positive, zero, or negative.
- # If `units` is negative, `nanos` must be negative or zero.
- # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
- "units": "A String", # The whole units of the amount.
- # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- },
- "labels": { # The labels describing the metric value.
- # See comments on google.api.servicecontrol.v1.Operation.labels for
- # the overriding relationship.
- # Note that this map must not contain monitored resource labels.
- "a_key": "A String",
- },
- "stringValue": "A String", # A text string value.
- "doubleValue": 3.14, # A double precision floating point value.
- "int64Value": "A String", # A signed 64-bit integer value.
"distributionValue": { # Distribution represents a frequency distribution of double-valued sample # A distribution value.
# points. It contains the size of the population of sample points plus
# additional optional information:
@@ -1717,10 +1687,51 @@
# - the minimum and maximum of the samples
# - the sum-squared-deviation of the samples, used to compute variance
# - a histogram of the values of the sample points
+ "bucketCounts": [ # The number of samples in each histogram bucket. `bucket_counts` are
+ # optional. If present, they must sum to the `count` value.
+ #
+ # The buckets are defined below in `bucket_option`. There are N buckets.
+ # `bucket_counts[0]` is the number of samples in the underflow bucket.
+ # `bucket_counts[1]` to `bucket_counts[N-1]` are the numbers of samples
+ # in each of the finite buckets. And `bucket_counts[N] is the number
+ # of samples in the overflow bucket. See the comments of `bucket_option`
+ # below for more details.
+ #
+ # Any suffix of trailing zeros may be omitted.
+ "A String",
+ ],
+ "count": "A String", # The total number of samples in the distribution. Must be >= 0.
"sumOfSquaredDeviation": 3.14, # The sum of squared deviations from the mean:
# Sum[i=1..count]((x_i - mean)^2)
# where each x_i is a sample values. If `count` is zero then this field
# must be zero, otherwise validation of the request fails.
+ "linearBuckets": { # Describing buckets with constant width. # Buckets with constant width.
+ "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
+ # the total number of buckets is `num_finite_buckets` + 2.
+ # See comments on `bucket_options` for details.
+ "offset": 3.14, # The i'th linear bucket covers the interval
+ # [offset + (i-1) * width, offset + i * width)
+ # where i ranges from 1 to num_finite_buckets, inclusive.
+ "width": 3.14, # The i'th linear bucket covers the interval
+ # [offset + (i-1) * width, offset + i * width)
+ # where i ranges from 1 to num_finite_buckets, inclusive.
+ # Must be strictly positive.
+ },
+ "maximum": 3.14, # The maximum of the population of values. Ignored if `count` is zero.
+ "exponentialBuckets": { # Describing buckets with exponentially growing width. # Buckets with exponentially growing width.
+ "growthFactor": 3.14, # The i'th exponential bucket covers the interval
+ # [scale * growth_factor^(i-1), scale * growth_factor^i)
+ # where i ranges from 1 to num_finite_buckets inclusive.
+ # Must be larger than 1.0.
+ "scale": 3.14, # The i'th exponential bucket covers the interval
+ # [scale * growth_factor^(i-1), scale * growth_factor^i)
+ # where i ranges from 1 to num_finite_buckets inclusive.
+ # Must be > 0.
+ "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
+ # the total number of buckets is `num_finite_buckets` + 2.
+ # See comments on `bucket_options` for details.
+ },
+ "minimum": 3.14, # The minimum of the population of values. Ignored if `count` is zero.
"exemplars": [ # Example points. Must be in increasing order of `value` field.
{ # Exemplars are example points that may be used to annotate aggregated
# distribution values. They are metadata that gives information about a
@@ -1729,7 +1740,6 @@
# such as a example values and timestamps, origin, etc.
"value": 3.14, # Value of the exemplar point. This value determines to which bucket the
# exemplar belongs.
- "timestamp": "A String", # The observation (sampling) time of the above value.
"attachments": [ # Contextual information about the example value. Examples are:
#
# Trace: type.googleapis.com/google.monitoring.v3.SpanContext
@@ -1745,50 +1755,11 @@
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
+ "timestamp": "A String", # The observation (sampling) time of the above value.
},
],
- "exponentialBuckets": { # Describing buckets with exponentially growing width. # Buckets with exponentially growing width.
- "growthFactor": 3.14, # The i'th exponential bucket covers the interval
- # [scale * growth_factor^(i-1), scale * growth_factor^i)
- # where i ranges from 1 to num_finite_buckets inclusive.
- # Must be larger than 1.0.
- "scale": 3.14, # The i'th exponential bucket covers the interval
- # [scale * growth_factor^(i-1), scale * growth_factor^i)
- # where i ranges from 1 to num_finite_buckets inclusive.
- # Must be > 0.
- "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
- # the total number of buckets is `num_finite_buckets` + 2.
- # See comments on `bucket_options` for details.
- },
- "minimum": 3.14, # The minimum of the population of values. Ignored if `count` is zero.
- "linearBuckets": { # Describing buckets with constant width. # Buckets with constant width.
- "numFiniteBuckets": 42, # The number of finite buckets. With the underflow and overflow buckets,
- # the total number of buckets is `num_finite_buckets` + 2.
- # See comments on `bucket_options` for details.
- "width": 3.14, # The i'th linear bucket covers the interval
- # [offset + (i-1) * width, offset + i * width)
- # where i ranges from 1 to num_finite_buckets, inclusive.
- # Must be strictly positive.
- "offset": 3.14, # The i'th linear bucket covers the interval
- # [offset + (i-1) * width, offset + i * width)
- # where i ranges from 1 to num_finite_buckets, inclusive.
- },
"mean": 3.14, # The arithmetic mean of the samples in the distribution. If `count` is
# zero then this field must be zero.
- "count": "A String", # The total number of samples in the distribution. Must be >= 0.
- "bucketCounts": [ # The number of samples in each histogram bucket. `bucket_counts` are
- # optional. If present, they must sum to the `count` value.
- #
- # The buckets are defined below in `bucket_option`. There are N buckets.
- # `bucket_counts[0]` is the number of samples in the underflow bucket.
- # `bucket_counts[1]` to `bucket_counts[N-1]` are the numbers of samples
- # in each of the finite buckets. And `bucket_counts[N] is the number
- # of samples in the overflow bucket. See the comments of `bucket_option`
- # below for more details.
- #
- # Any suffix of trailing zeros may be omitted.
- "A String",
- ],
"explicitBuckets": { # Describing buckets with arbitrary user-provided width. # Buckets with arbitrary user-provided width.
"bounds": [ # 'bound' is a list of strictly increasing boundaries between
# buckets. Note that a list of length N-1 defines N buckets because
@@ -1808,19 +1779,57 @@
3.14,
],
},
- "maximum": 3.14, # The maximum of the population of values. Ignored if `count` is zero.
},
- "boolValue": True or False, # A boolean value.
+ "labels": { # The labels describing the metric value.
+ # See comments on google.api.servicecontrol.v1.Operation.labels for
+ # the overriding relationship.
+ # Note that this map must not contain monitored resource labels.
+ "a_key": "A String",
+ },
+ "doubleValue": 3.14, # A double precision floating point value.
"endTime": "A String", # The end of the time period over which this metric value's measurement
# applies.
+ "boolValue": True or False, # A boolean value.
+ "int64Value": "A String", # A signed 64-bit integer value.
+ "moneyValue": { # Represents an amount of money with its currency type. # A money value.
+ "nanos": 42, # Number of nano (10^-9) units of the amount.
+ # The value must be between -999,999,999 and +999,999,999 inclusive.
+ # If `units` is positive, `nanos` must be positive or zero.
+ # If `units` is zero, `nanos` can be positive, zero, or negative.
+ # If `units` is negative, `nanos` must be negative or zero.
+ # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+ "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+ },
+ "stringValue": "A String", # A text string value.
},
],
+ "metricName": "A String", # The metric name defined in the service configuration.
},
],
+ "limitExceeded": [ # Quota Metrics that have exceeded quota limits.
+ # For QuotaGroup-based quota, this is QuotaGroup.name
+ # For QuotaLimit-based quota, this is QuotaLimit.name
+ # See: google.api.Quota
+ # Deprecated: Use quota_metrics to get per quota group limit exceeded status.
+ "A String",
+ ],
+ "quotaConsumed": { # Map of quota group name to the actual number of tokens consumed. If the
+ # quota check was not successful, then this will not be populated due to no
+ # quota consumption.
+ #
+ # We are not merging this field with 'quota_metrics' field because of the
+ # complexity of scaling in Chemist client code base. For simplicity, we will
+ # keep this field for Castor (that scales quota usage) and 'quota_metrics'
+ # for SuperQuota (that doesn't scale quota usage).
+ "a_key": 42,
+ },
},
+ "operationId": "A String", # The Operation.operation_id value from the request.
},
],
- "serviceConfigId": "A String", # The actual config id used to process the request.
+ "serviceRolloutId": "A String", # The current service rollout id used to process the request.
"reportErrors": [ # Partial failures, one for each `Operation` in the request that failed
# processing. There are three possible combinations of the RPC status:
#
@@ -1836,7 +1845,6 @@
# When this happens, it's impossible to know which of the
# 'Operations' in the request succeeded or failed.
{ # Represents the processing error of one Operation in the request.
- "operationId": "A String", # The Operation.operation_id value from the request.
"status": { # The `Status` type defines a logical error model that is suitable for # Details of the error when processing the Operation.
# different programming environments, including REST APIs and RPC APIs. It is
# used by [gRPC](https://github.com/grpc). Each `Status` message contains
@@ -1844,10 +1852,10 @@
#
# 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).
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
"message": "A String", # A developer-facing error message, which should be in English. Any
# user-facing error message should be localized and sent in the
# google.rpc.Status.details field, or localized by the client.
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
"details": [ # A list of messages that carry the error details. There is a common set of
# message types for APIs to use.
{
@@ -1855,8 +1863,10 @@
},
],
},
+ "operationId": "A String", # The Operation.operation_id value from the request.
},
],
+ "serviceConfigId": "A String", # The actual config id used to process the request.
}</pre>
</div>