update all APIs

Like documented in the README

```
rm -f .api.deps .cli.deps && FETCH_APIS=1 make update-json -j8
```
This commit is contained in:
Sebastian Thiel
2024-03-05 18:54:36 +01:00
parent 8a12e9d47e
commit ca974aa0a5
347 changed files with 202580 additions and 50157 deletions

View File

@@ -379,7 +379,7 @@
"type": "integer"
},
"pageToken": {
"description": "If this field is not empty then it must contain the nextPageToken value returned by a previous call to this method. Using this field causes the method to return additional results from the previous method call.",
"description": "Optional. If this field is not empty then it must contain the nextPageToken value returned by a previous call to this method. Using this field causes the method to return additional results from the previous method call.",
"location": "query",
"type": "string"
},
@@ -411,7 +411,7 @@
],
"parameters": {
"name": {
"description": "Immutable. The resource name of the dashboard.",
"description": "Identifier. The resource name of the dashboard.",
"location": "path",
"pattern": "^projects/[^/]+/dashboards/[^/]+$",
"required": true,
@@ -472,7 +472,7 @@
},
"path": "v1/{+name}/location/{location}/prometheus/api/v1/labels",
"request": {
"$ref": "ListLabelsRequest"
"$ref": "QueryLabelsRequest"
},
"response": {
"$ref": "HttpBody"
@@ -520,6 +520,43 @@
"https://www.googleapis.com/auth/monitoring.read"
]
},
"query_exemplars": {
"description": "Lists exemplars relevant to a given PromQL query,",
"flatPath": "v1/projects/{projectsId}/location/{location}/prometheus/api/v1/query_exemplars",
"httpMethod": "POST",
"id": "monitoring.projects.location.prometheus.api.v1.query_exemplars",
"parameterOrder": [
"name",
"location"
],
"parameters": {
"location": {
"description": "Location of the resource information. Has to be \"global\" now.",
"location": "path",
"required": true,
"type": "string"
},
"name": {
"description": "The project on which to execute the request. Data associcated with the project's workspace stored under the The format is: projects/PROJECT_ID_OR_NUMBER. Open source API but used as a request path prefix to distinguish different virtual Prometheus instances of Google Prometheus Engine.",
"location": "path",
"pattern": "^projects/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1/{+name}/location/{location}/prometheus/api/v1/query_exemplars",
"request": {
"$ref": "QueryExemplarsRequest"
},
"response": {
"$ref": "HttpBody"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/monitoring",
"https://www.googleapis.com/auth/monitoring.read"
]
},
"query_range": {
"description": "Evaluate a PromQL query with start, end time range.",
"flatPath": "v1/projects/{projectsId}/location/{location}/prometheus/api/v1/query_range",
@@ -656,59 +693,6 @@
}
}
},
"labels": {
"methods": {
"list": {
"description": "Lists labels for metrics.",
"flatPath": "v1/projects/{projectsId}/location/{location}/prometheus/api/v1/labels",
"httpMethod": "GET",
"id": "monitoring.projects.location.prometheus.api.v1.labels.list",
"parameterOrder": [
"name",
"location"
],
"parameters": {
"end": {
"description": "The end time to evaluate the query for. Either floating point UNIX seconds or RFC3339 formatted timestamp.",
"location": "query",
"type": "string"
},
"location": {
"description": "Location of the resource information. Has to be \"global\" now.",
"location": "path",
"required": true,
"type": "string"
},
"match": {
"description": "A list of matchers encoded in the Prometheus label matcher format to constrain the values to series that satisfy them.",
"location": "query",
"type": "string"
},
"name": {
"description": "The workspace on which to execute the request. It is not part of the open source API but used as a request path prefix to distinguish different virtual Prometheus instances of Google Prometheus Engine. The format is: projects/PROJECT_ID_OR_NUMBER.",
"location": "path",
"pattern": "^projects/[^/]+$",
"required": true,
"type": "string"
},
"start": {
"description": "The start time to evaluate the query for. Either floating point UNIX seconds or RFC3339 formatted timestamp.",
"location": "query",
"type": "string"
}
},
"path": "v1/{+name}/location/{location}/prometheus/api/v1/labels",
"response": {
"$ref": "HttpBody"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/monitoring",
"https://www.googleapis.com/auth/monitoring.read"
]
}
}
},
"metadata": {
"methods": {
"list": {
@@ -769,7 +753,7 @@
}
}
},
"revision": "20230115",
"revision": "20240225",
"rootUrl": "https://monitoring.googleapis.com/",
"schemas": {
"Aggregation": {
@@ -873,6 +857,24 @@
},
"type": "object"
},
"AggregationFunction": {
"description": "Preview: An identifier for an aggregation function. Aggregation functions are SQL functions that group or transform data from multiple points to a single point. This is a preview feature and may be subject to change before final release.",
"id": "AggregationFunction",
"properties": {
"parameters": {
"description": "Optional. Parameters applied to the aggregation function. Only used for functions that require them.",
"items": {
"$ref": "Parameter"
},
"type": "array"
},
"type": {
"description": "Required. The type of aggregation function, must be one of the following: \"none\" - no function. \"percentile\" - APPROX_QUANTILES() - 1 parameter numeric value \"average\" - AVG() \"count\" - COUNT() \"count-distinct\" - COUNT(DISTINCT) \"count-distinct-approx\" - APPROX_COUNT_DISTINCT() \"max\" - MAX() \"min\" - MIN() \"sum\" - SUM()",
"type": "string"
}
},
"type": "object"
},
"AlertChart": {
"description": "A chart that displays alert policy data.",
"id": "AlertChart",
@@ -909,10 +911,50 @@
},
"type": "object"
},
"Breakdown": {
"description": "Preview: A breakdown is an aggregation applied to the measures over a specified column. A breakdown can result in multiple series across a category for the provided measure. This is a preview feature and may be subject to change before final release.",
"id": "Breakdown",
"properties": {
"aggregationFunction": {
"$ref": "AggregationFunction",
"description": "Required. The Aggregation function is applied across all data in each breakdown created."
},
"column": {
"description": "Required. The name of the column in the dataset containing the breakdown values.",
"type": "string"
},
"limit": {
"description": "Required. A limit to the number of breakdowns. If set to zero then all possible breakdowns are applied. The list of breakdowns is dependent on the value of the sort_order field.",
"format": "int32",
"type": "integer"
},
"sortOrder": {
"description": "Required. The sort order is applied to the values of the breakdown column.",
"enum": [
"SORT_ORDER_UNSPECIFIED",
"SORT_ORDER_NONE",
"SORT_ORDER_ASCENDING",
"SORT_ORDER_DESCENDING"
],
"enumDescriptions": [
"An unspecified sort order. This option is invalid when sorting is required.",
"No sorting is applied.",
"The lowest-valued entries are selected first.",
"The highest-valued entries are selected first."
],
"type": "string"
}
},
"type": "object"
},
"ChartOptions": {
"description": "Options to control visual rendering of a chart.",
"id": "ChartOptions",
"properties": {
"displayHorizontal": {
"description": "Preview: Configures whether the charted values are shown on the horizontal or vertical axis. By default, values are represented the vertical axis. This is a preview feature and may be subject to change before final release.",
"type": "boolean"
},
"mode": {
"description": "The chart mode.",
"enum": [
@@ -1030,7 +1072,7 @@
"description": "The content is arranged as a grid of tiles, with each content widget occupying one or more grid blocks."
},
"name": {
"description": "Immutable. The resource name of the dashboard.",
"description": "Identifier. The resource name of the dashboard.",
"type": "string"
},
"rowLayout": {
@@ -1083,10 +1125,31 @@
"description": "Groups a time series query definition with charting options.",
"id": "DataSet",
"properties": {
"breakdowns": {
"description": "Optional. The collection of breakdowns to be applied to the dataset.",
"items": {
"$ref": "Breakdown"
},
"type": "array"
},
"dimensions": {
"description": "Optional. A collection of dimension columns.",
"items": {
"$ref": "Dimension"
},
"type": "array"
},
"legendTemplate": {
"description": "A template string for naming TimeSeries in the resulting data set. This should be a string with interpolations of the form ${label_name}, which will resolve to the label's value.",
"type": "string"
},
"measures": {
"description": "Optional. A collection of measures.",
"items": {
"$ref": "Measure"
},
"type": "array"
},
"minAlignmentPeriod": {
"description": "Optional. The lower bound on data point frequency for this data set, implemented by specifying the minimum alignment period to use in a time series query For example, if the data is published once every 10 minutes, the min_alignment_period should be at least 10 minutes. It would not make sense to fetch and align data at one minute intervals.",
"format": "google-duration",
@@ -1104,8 +1167,8 @@
"enumDescriptions": [
"Plot type is unspecified. The view will default to LINE.",
"The data is plotted as a set of lines (one line per series).",
"The data is plotted as a set of filled areas (one area per series), with the areas stacked vertically (the base of each area is the top of its predecessor, and the base of the first area is the X axis). Since the areas do not overlap, each is filled with a different opaque color.",
"The data is plotted as a set of rectangular boxes (one box per series), with the boxes stacked vertically (the base of each box is the top of its predecessor, and the base of the first box is the X axis). Since the boxes do not overlap, each is filled with a different opaque color.",
"The data is plotted as a set of filled areas (one area per series), with the areas stacked vertically (the base of each area is the top of its predecessor, and the base of the first area is the x-axis). Since the areas do not overlap, each is filled with a different opaque color.",
"The data is plotted as a set of rectangular boxes (one box per series), with the boxes stacked vertically (the base of each box is the top of its predecessor, and the base of the first box is the x-axis). Since the boxes do not overlap, each is filled with a different opaque color.",
"The data is plotted as a heatmap. The series being plotted must have a DISTRIBUTION value type. The value of each bucket in the distribution is displayed as a color. This type is not currently available in the Stackdriver Monitoring application."
],
"type": "string"
@@ -1131,6 +1194,61 @@
},
"type": "object"
},
"Dimension": {
"description": "A chart dimension. Dimensions are a structured label, class, or category for a set of measurements in your data.",
"id": "Dimension",
"properties": {
"column": {
"description": "Required. The name of the column in the source SQL query that is used to chart the dimension.",
"type": "string"
},
"columnType": {
"description": "Optional. The type of the dimension column. This is relevant only if one of the bin_size fields is set. If it is empty, the type TIMESTAMP or INT64 will be assumed based on which bin_size field is set. If populated, this should be set to one of the following types: DATE, TIME, DATETIME, TIMESTAMP, BIGNUMERIC, INT64, NUMERIC, FLOAT64.",
"type": "string"
},
"floatBinSize": {
"description": "Optional. float_bin_size is used when the column type used for a dimension is a floating point numeric column.",
"format": "double",
"type": "number"
},
"maxBinCount": {
"description": "A limit to the number of bins generated. When 0 is specified, the maximum count is not enforced.",
"format": "int32",
"type": "integer"
},
"numericBinSize": {
"description": "numeric_bin_size is used when the column type used for a dimension is numeric or string.",
"format": "int32",
"type": "integer"
},
"sortColumn": {
"description": "The column name to sort on for binning. This column can be the same column as this dimension or any other column used as a measure in the results. If sort_order is set to NONE, then this value is not used.",
"type": "string"
},
"sortOrder": {
"description": "The sort order applied to the sort column.",
"enum": [
"SORT_ORDER_UNSPECIFIED",
"SORT_ORDER_NONE",
"SORT_ORDER_ASCENDING",
"SORT_ORDER_DESCENDING"
],
"enumDescriptions": [
"An unspecified sort order. This option is invalid when sorting is required.",
"No sorting is applied.",
"The lowest-valued entries are selected first.",
"The highest-valued entries are selected first."
],
"type": "string"
},
"timeBinSize": {
"description": "time_bin_size is used when the data type specified by column is a time type and the bin size is determined by a time duration. If column_type is DATE, this must be a whole value multiple of 1 day. If column_type is TIME, this must be less than or equal to 24 hours.",
"format": "google-duration",
"type": "string"
}
},
"type": "object"
},
"DroppedLabels": {
"description": "A set of (label, value) pairs that were removed from a Distribution time series during aggregation and then added as an attachment to a Distribution.Exemplar.The full label set for the exemplars is constructed by using the dropped pairs in combination with the label values that remain on the aggregated Distribution time series. The constructed full label set can be used to identify the specific entity, such as the instance or job, which might be contributing to a long-tail. However, with dropped labels, the storage requirements are reduced because only the aggregated distribution values for a large group of time series are stored.Note that there are no guarantees on ordering of the labels from exemplar-to-exemplar and from distribution-to-distribution in the same stream, and there may be duplicates. It is up to clients to resolve any ambiguities.",
"id": "DroppedLabels",
@@ -1151,6 +1269,34 @@
"properties": {},
"type": "object"
},
"ErrorReportingPanel": {
"description": "A widget that displays a list of error groups.",
"id": "ErrorReportingPanel",
"properties": {
"projectNames": {
"description": "The resource name of the Google Cloud Platform project. Written as projects/{projectID} or projects/{projectNumber}, where {projectID} and {projectNumber} can be found in the Google Cloud console (https://support.google.com/cloud/answer/6158840).Examples: projects/my-project-123, projects/5551234.",
"items": {
"type": "string"
},
"type": "array"
},
"services": {
"description": "An identifier of the service, such as the name of the executable, job, or Google App Engine service name. This field is expected to have a low number of values that are relatively stable over time, as opposed to version, which can be changed whenever new code is deployed.Contains the service name for error reports extracted from Google App Engine logs or default if the App Engine default service is used.",
"items": {
"type": "string"
},
"type": "array"
},
"versions": {
"description": "Represents the source code version that the developer provided, which could represent a version label or a Git SHA-1 hash, for example. For App Engine standard environment, the version is set to the version of the app.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"Field": {
"description": "A single field of a message type.",
"id": "Field",
@@ -1320,6 +1466,44 @@
},
"type": "object"
},
"IncidentList": {
"description": "A widget that displays a list of incidents",
"id": "IncidentList",
"properties": {
"monitoredResources": {
"description": "Optional. The monitored resource for which incidents are listed. The resource doesn't need to be fully specified. That is, you can specify the resource type but not the values of the resource labels. The resource type and labels are used for filtering.",
"items": {
"$ref": "MonitoredResource"
},
"type": "array"
},
"policyNames": {
"description": "Optional. A list of alert policy names to filter the incident list by. Don't include the project ID prefix in the policy name. For example, use alertPolicies/utilization.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"Interval": {
"description": "Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive).The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time.",
"id": "Interval",
"properties": {
"endTime": {
"description": "Optional. Exclusive end of the interval.If specified, a Timestamp matching this interval will have to be before the end.",
"format": "google-datetime",
"type": "string"
},
"startTime": {
"description": "Optional. Inclusive start of the interval.If specified, a Timestamp matching this interval will have to be the same or after the start.",
"format": "google-datetime",
"type": "string"
}
},
"type": "object"
},
"ListDashboardsResponse": {
"description": "The ListDashboards request.",
"id": "ListDashboardsResponse",
@@ -1338,25 +1522,6 @@
},
"type": "object"
},
"ListLabelsRequest": {
"description": "ListLabelsRequest holds all parameters of the Prometheus upstream API for returning a list of label names.",
"id": "ListLabelsRequest",
"properties": {
"end": {
"description": "The end time to evaluate the query for. Either floating point UNIX seconds or RFC3339 formatted timestamp.",
"type": "string"
},
"match": {
"description": "A list of matchers encoded in the Prometheus label matcher format to constrain the values to series that satisfy them.",
"type": "string"
},
"start": {
"description": "The start time to evaluate the query for. Either floating point UNIX seconds or RFC3339 formatted timestamp.",
"type": "string"
}
},
"type": "object"
},
"ListMetricsScopesByMonitoredProjectResponse": {
"description": "Response for the ListMetricsScopesByMonitoredProject method.",
"id": "ListMetricsScopesByMonitoredProjectResponse",
@@ -1389,6 +1554,21 @@
},
"type": "object"
},
"Measure": {
"description": "A chart measure. Measures represent a measured property in your chart data such as rainfall in inches, number of units sold, revenue gained, etc.",
"id": "Measure",
"properties": {
"aggregationFunction": {
"$ref": "AggregationFunction",
"description": "Required. The aggregation function applied to the input column. This must not be set to \"none\" unless binning is disabled on the dimension. The aggregation function is used to group points on the dimension bins."
},
"column": {
"description": "Required. The column name within in the dataset used for the measure.",
"type": "string"
}
},
"type": "object"
},
"MetricsScope": {
"description": "Represents a Metrics Scope (https://cloud.google.com/monitoring/settings#concept-scope) in Cloud Monitoring, which specifies one or more Google projects and zero or more AWS accounts to monitor together.",
"id": "MetricsScope",
@@ -1437,6 +1617,24 @@
},
"type": "object"
},
"MonitoredResource": {
"description": "An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The type field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the labels field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for \"gce_instance\" has labels \"project_id\", \"instance_id\" and \"zone\": { \"type\": \"gce_instance\", \"labels\": { \"project_id\": \"my-project\", \"instance_id\": \"12345678901234\", \"zone\": \"us-central1-a\" }} ",
"id": "MonitoredResource",
"properties": {
"labels": {
"additionalProperties": {
"type": "string"
},
"description": "Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Compute Engine VM instances use the labels \"project_id\", \"instance_id\", and \"zone\".",
"type": "object"
},
"type": {
"description": "Required. The monitored resource type. This field must match the type field of a MonitoredResourceDescriptor object. For example, the type of a Compute Engine VM instance is gce_instance. For a list of types, see Monitoring resource types (https://cloud.google.com/monitoring/api/resources) and Logging resource types (https://cloud.google.com/logging/docs/api/v2/resource-list).",
"type": "string"
}
},
"type": "object"
},
"MosaicLayout": {
"description": "A mosaic layout divides the available space into a grid of blocks, and overlays the grid with tiles. Unlike GridLayout, tiles may span multiple grid blocks and can be placed at arbitrary locations in the grid.",
"id": "MosaicLayout",
@@ -1485,7 +1683,7 @@
"description": "Properties of the object. Contains field @type with type URL.",
"type": "any"
},
"description": "The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.",
"description": "The normal, successful response of the operation. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.",
"type": "object"
}
},
@@ -1526,6 +1724,17 @@
},
"type": "object"
},
"OpsAnalyticsQuery": {
"description": "Preview: A query that produces an aggregated response and supporting data. This is a preview feature and may be subject to change before final release.",
"id": "OpsAnalyticsQuery",
"properties": {
"sql": {
"description": "A SQL query to fetch time series, category series, or numeric series data.",
"type": "string"
}
},
"type": "object"
},
"Option": {
"description": "A protocol buffer option, which can be attached to a message, field, enumeration, etc.",
"id": "Option",
@@ -1545,6 +1754,23 @@
},
"type": "object"
},
"Parameter": {
"description": "Preview: Parameter value applied to the aggregation function. This is a preview feature and may be subject to change before final release.",
"id": "Parameter",
"properties": {
"doubleValue": {
"description": "A floating-point parameter value.",
"format": "double",
"type": "number"
},
"intValue": {
"description": "An integer parameter value.",
"format": "int64",
"type": "string"
}
},
"type": "object"
},
"PickTimeSeriesFilter": {
"description": "Describes a ranking-based time series filter. Each input time series is ranked with an aligner. The filter will allow up to num_time_series time series to pass through it, selecting them based on the relative ranking.For example, if ranking_method is METHOD_MEAN,direction is BOTTOM, and num_time_series is 3, then the 3 times series with the lowest mean values will pass through the filter.",
"id": "PickTimeSeriesFilter",
@@ -1563,6 +1789,10 @@
],
"type": "string"
},
"interval": {
"$ref": "Interval",
"description": "Select the top N streams/time series within this time interval"
},
"numTimeSeries": {
"description": "How many time series to allow to pass through the filter.",
"format": "int32",
@@ -1591,6 +1821,91 @@
},
"type": "object"
},
"PieChart": {
"description": "A widget that displays timeseries data as a pie or a donut.",
"id": "PieChart",
"properties": {
"chartType": {
"description": "Required. Indicates the visualization type for the PieChart.",
"enum": [
"PIE_CHART_TYPE_UNSPECIFIED",
"PIE",
"DONUT"
],
"enumDescriptions": [
"The zero value. No type specified. Do not use.",
"A Pie type PieChart.",
"Similar to PIE, but the DONUT type PieChart has a hole in the middle."
],
"type": "string"
},
"dataSets": {
"description": "Required. The queries for the chart's data.",
"items": {
"$ref": "PieChartDataSet"
},
"type": "array"
},
"showLabels": {
"description": "Optional. Indicates whether or not the pie chart should show slices' labels",
"type": "boolean"
}
},
"type": "object"
},
"PieChartDataSet": {
"description": "Groups a time series query definition.",
"id": "PieChartDataSet",
"properties": {
"dimensions": {
"description": "A dimension is a structured label, class, or category for a set of measurements in your data.",
"items": {
"$ref": "Dimension"
},
"type": "array"
},
"measures": {
"description": "A measure is a measured value of a property in your data. For example, rainfall in inches, number of units sold, revenue gained, etc.",
"items": {
"$ref": "Measure"
},
"type": "array"
},
"minAlignmentPeriod": {
"description": "Optional. The lower bound on data point frequency for this data set, implemented by specifying the minimum alignment period to use in a time series query. For example, if the data is published once every 10 minutes, the min_alignment_period should be at least 10 minutes. It would not make sense to fetch and align data at one minute intervals.",
"format": "google-duration",
"type": "string"
},
"sliceNameTemplate": {
"description": "Optional. A template for the name of the slice. This name will be displayed in the legend and the tooltip of the pie chart. It replaces the auto-generated names for the slices. For example, if the template is set to ${resource.labels.zone}, the zone's value will be used for the name instead of the default name.",
"type": "string"
},
"timeSeriesQuery": {
"$ref": "TimeSeriesQuery",
"description": "Required. The query for the PieChart. See, google.monitoring.dashboard.v1.TimeSeriesQuery."
}
},
"type": "object"
},
"QueryExemplarsRequest": {
"description": "QueryExemplarsRequest holds all parameters of the Prometheus upstream API for querying exemplars.",
"id": "QueryExemplarsRequest",
"properties": {
"end": {
"description": "The end time to evaluate the query for. Either floating point UNIX seconds or RFC3339 formatted timestamp.",
"type": "string"
},
"query": {
"description": "A PromQL query string. Query lanauge documentation: https://prometheus.io/docs/prometheus/latest/querying/basics/.",
"type": "string"
},
"start": {
"description": "The start time to evaluate the query for. Either floating point UNIX seconds or RFC3339 formatted timestamp.",
"type": "string"
}
},
"type": "object"
},
"QueryInstantRequest": {
"description": "QueryInstantRequest holds all parameters of the Prometheus upstream instant query API plus GCM specific parameters.",
"id": "QueryInstantRequest",
@@ -1610,6 +1925,25 @@
},
"type": "object"
},
"QueryLabelsRequest": {
"description": "QueryLabelsRequest holds all parameters of the Prometheus upstream API for returning a list of label names.",
"id": "QueryLabelsRequest",
"properties": {
"end": {
"description": "The end time to evaluate the query for. Either floating point UNIX seconds or RFC3339 formatted timestamp.",
"type": "string"
},
"match": {
"description": "A list of matchers encoded in the Prometheus label matcher format to constrain the values to series that satisfy them.",
"type": "string"
},
"start": {
"description": "The start time to evaluate the query for. Either floating point UNIX seconds or RFC3339 formatted timestamp.",
"type": "string"
}
},
"type": "object"
},
"QueryRangeRequest": {
"description": "QueryRangeRequest holds all parameters of the Prometheus upstream range query API plus GCM specific parameters.",
"id": "QueryRangeRequest",
@@ -1704,6 +2038,10 @@
"description": "A widget showing the latest value of a metric, and how this value relates to one or more thresholds.",
"id": "Scorecard",
"properties": {
"blankView": {
"$ref": "Empty",
"description": "Will cause the Scorecard to show only the value, with no indicator to its value relative to its thresholds."
},
"gaugeView": {
"$ref": "GaugeView",
"description": "Will cause the scorecard to show a gauge chart."
@@ -1726,6 +2064,27 @@
},
"type": "object"
},
"SectionHeader": {
"description": "A widget that defines a new section header. Sections populate a table of contents and allow easier navigation of long-form content.",
"id": "SectionHeader",
"properties": {
"dividerBelow": {
"description": "Whether to insert a divider below the section in the table of contents",
"type": "boolean"
},
"subtitle": {
"description": "The subtitle of the section",
"type": "string"
}
},
"type": "object"
},
"SingleViewGroup": {
"description": "A widget that groups the other widgets by using a dropdown menu. All widgets that are within the area spanned by the grouping widget are considered member widgets.",
"id": "SingleViewGroup",
"properties": {},
"type": "object"
},
"SourceContext": {
"description": "SourceContext represents information about the source of a protobuf element, like the file in which it is defined.",
"id": "SourceContext",
@@ -1854,6 +2213,7 @@
"id": "TableDisplayOptions",
"properties": {
"shownColumns": {
"deprecated": true,
"description": "Optional. This field is unused and has been replaced by TimeSeriesTable.column_settings",
"items": {
"type": "string"
@@ -1884,6 +2244,131 @@
"The text contains no special formatting."
],
"type": "string"
},
"style": {
"$ref": "TextStyle",
"description": "How the text is styled"
}
},
"type": "object"
},
"TextStyle": {
"description": "Properties that determine how the title and content are styled",
"id": "TextStyle",
"properties": {
"backgroundColor": {
"description": "The background color as a hex string. \"#RRGGBB\" or \"#RGB\"",
"type": "string"
},
"fontSize": {
"description": "Font sizes for both the title and content. The title will still be larger relative to the content.",
"enum": [
"FONT_SIZE_UNSPECIFIED",
"FS_EXTRA_SMALL",
"FS_SMALL",
"FS_MEDIUM",
"FS_LARGE",
"FS_EXTRA_LARGE"
],
"enumDescriptions": [
"No font size specified, will default to FS_LARGE",
"Extra small font size",
"Small font size",
"Medium font size",
"Large font size",
"Extra large font size"
],
"type": "string"
},
"horizontalAlignment": {
"description": "The horizontal alignment of both the title and content",
"enum": [
"HORIZONTAL_ALIGNMENT_UNSPECIFIED",
"H_LEFT",
"H_CENTER",
"H_RIGHT"
],
"enumDescriptions": [
"No horizontal alignment specified, will default to H_LEFT",
"Left-align",
"Center-align",
"Right-align"
],
"type": "string"
},
"padding": {
"description": "The amount of padding around the widget",
"enum": [
"PADDING_SIZE_UNSPECIFIED",
"P_EXTRA_SMALL",
"P_SMALL",
"P_MEDIUM",
"P_LARGE",
"P_EXTRA_LARGE"
],
"enumDescriptions": [
"No padding size specified, will default to P_EXTRA_SMALL",
"Extra small padding",
"Small padding",
"Medium padding",
"Large padding",
"Extra large padding"
],
"type": "string"
},
"pointerLocation": {
"description": "The pointer location for this widget (also sometimes called a \"tail\")",
"enum": [
"POINTER_LOCATION_UNSPECIFIED",
"PL_TOP",
"PL_RIGHT",
"PL_BOTTOM",
"PL_LEFT",
"PL_TOP_LEFT",
"PL_TOP_RIGHT",
"PL_RIGHT_TOP",
"PL_RIGHT_BOTTOM",
"PL_BOTTOM_RIGHT",
"PL_BOTTOM_LEFT",
"PL_LEFT_BOTTOM",
"PL_LEFT_TOP"
],
"enumDescriptions": [
"No visual pointer",
"Placed in the middle of the top of the widget",
"Placed in the middle of the right side of the widget",
"Placed in the middle of the bottom of the widget",
"Placed in the middle of the left side of the widget",
"Placed on the left side of the top of the widget",
"Placed on the right side of the top of the widget",
"Placed on the top of the right side of the widget",
"Placed on the bottom of the right side of the widget",
"Placed on the right side of the bottom of the widget",
"Placed on the left side of the bottom of the widget",
"Placed on the bottom of the left side of the widget",
"Placed on the top of the left side of the widget"
],
"type": "string"
},
"textColor": {
"description": "The text color as a hex string. \"#RRGGBB\" or \"#RGB\"",
"type": "string"
},
"verticalAlignment": {
"description": "The vertical alignment of both the title and content",
"enum": [
"VERTICAL_ALIGNMENT_UNSPECIFIED",
"V_TOP",
"V_CENTER",
"V_BOTTOM"
],
"enumDescriptions": [
"No vertical alignment specified, will default to V_TOP",
"Top-align",
"Center-align",
"Bottom-align"
],
"type": "string"
}
},
"type": "object"
@@ -1999,6 +2484,7 @@
},
"statisticalTimeSeriesFilter": {
"$ref": "StatisticalTimeSeriesFilter",
"deprecated": true,
"description": "Statistics based time series filter. Note: This field is deprecated and completely ignored by the API."
}
},
@@ -2026,6 +2512,7 @@
},
"statisticalTimeSeriesFilter": {
"$ref": "StatisticalTimeSeriesFilter",
"deprecated": true,
"description": "Statistics based time series filter. Note: This field is deprecated and completely ignored by the API."
}
},
@@ -2035,6 +2522,14 @@
"description": "TimeSeriesQuery collects the set of supported methods for querying time series data from the Stackdriver metrics API.",
"id": "TimeSeriesQuery",
"properties": {
"opsAnalyticsQuery": {
"$ref": "OpsAnalyticsQuery",
"description": "Preview: A query used to fetch a time series, category series, or numeric series with SQL. This is a preview feature and may be subject to change before final release."
},
"outputFullDuration": {
"description": "Optional. If set, Cloud Monitoring will treat the full query duration as the alignment period so that there will be only 1 output value.*Note: This could override the configured alignment period except for the cases where a series of data points are expected, like - XyChart - Scorecard's spark chart",
"type": "boolean"
},
"prometheusQuery": {
"description": "A query used to fetch time series with PromQL.",
"type": "string"
@@ -2097,6 +2592,10 @@
"description": "A protocol buffer message type.",
"id": "Type",
"properties": {
"edition": {
"description": "The source edition string, only valid when syntax is SYNTAX_EDITIONS.",
"type": "string"
},
"fields": {
"description": "The list of fields.",
"items": {
@@ -2130,11 +2629,13 @@
"description": "The source syntax.",
"enum": [
"SYNTAX_PROTO2",
"SYNTAX_PROTO3"
"SYNTAX_PROTO3",
"SYNTAX_EDITIONS"
],
"enumDescriptions": [
"Syntax proto2.",
"Syntax proto3."
"Syntax proto3.",
"Syntax editions."
],
"type": "string"
}
@@ -2157,14 +2658,38 @@
"$ref": "CollapsibleGroup",
"description": "A widget that groups the other widgets. All widgets that are within the area spanned by the grouping widget are considered member widgets."
},
"errorReportingPanel": {
"$ref": "ErrorReportingPanel",
"description": "A widget that displays a list of error groups."
},
"id": {
"description": "Optional. The widget id. Ids may be made up of alphanumerics, dashes and underscores. Widget ids are optional.",
"type": "string"
},
"incidentList": {
"$ref": "IncidentList",
"description": "A widget that shows list of incidents."
},
"logsPanel": {
"$ref": "LogsPanel",
"description": "A widget that shows a stream of logs."
},
"pieChart": {
"$ref": "PieChart",
"description": "A widget that displays timeseries data as a pie chart."
},
"scorecard": {
"$ref": "Scorecard",
"description": "A scorecard summarizing time series data."
},
"sectionHeader": {
"$ref": "SectionHeader",
"description": "A widget that defines a section header for easier navigation of the dashboard."
},
"singleViewGroup": {
"$ref": "SingleViewGroup",
"description": "A widget that groups the other widgets by using a dropdown menu."
},
"text": {
"$ref": "Text",
"description": "A raw string or markdown displaying textual content."
@@ -2213,15 +2738,15 @@
},
"xAxis": {
"$ref": "Axis",
"description": "The properties applied to the X axis."
"description": "The properties applied to the x-axis."
},
"y2Axis": {
"$ref": "Axis",
"description": "The properties applied to the Y2 axis."
"description": "The properties applied to the y2-axis."
},
"yAxis": {
"$ref": "Axis",
"description": "The properties applied to the Y axis."
"description": "The properties applied to the y-axis."
}
},
"type": "object"