chore: Update discovery artifacts (#1379)
## Deleted keys were detected in the following stable discovery artifacts:
servicemanagement v1 https://github.com/googleapis/google-api-python-client/commit/ac046117b12b43e03e748ebd0c442b340ed99183
## Discovery Artifact Change Summary:
feat(adexchangebuyer2): update the api https://github.com/googleapis/google-api-python-client/commit/e1ebe49bc9e2e007c61188202f0345c96083c19a
feat(displayvideo): update the api https://github.com/googleapis/google-api-python-client/commit/4f37d8b0d43f2172fdae627605947b3ba15b06c2
feat(gkehub): update the api https://github.com/googleapis/google-api-python-client/commit/e12ff0958ed9016356c8711039a15334d2f0d6f6
feat(servicemanagement): update the api https://github.com/googleapis/google-api-python-client/commit/ac046117b12b43e03e748ebd0c442b340ed99183
feat(spanner): update the api https://github.com/googleapis/google-api-python-client/commit/43f1be2ea175a79e463d77cf3155e7b8ab1b26f6
diff --git a/docs/dyn/spanner_v1.projects.instances.databases.html b/docs/dyn/spanner_v1.projects.instances.databases.html
index d9c966f..aa4b0dc 100644
--- a/docs/dyn/spanner_v1.projects.instances.databases.html
+++ b/docs/dyn/spanner_v1.projects.instances.databases.html
@@ -103,6 +103,9 @@
<code><a href="#getIamPolicy">getIamPolicy(resource, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Gets the access control policy for a database or backup resource. Returns an empty policy if a database or backup exists but does not have a policy set. Authorization requires `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.getIamPolicy` permission on resource.</p>
<p class="toc_element">
+ <code><a href="#getScans">getScans(name, endTime=None, startTime=None, view=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Request a specific scan with Database-specific data for Cloud Key Visualizer.</p>
+<p class="toc_element">
<code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists Cloud Spanner databases.</p>
<p class="toc_element">
@@ -307,6 +310,210 @@
</div>
<div class="method">
+ <code class="details" id="getScans">getScans(name, endTime=None, startTime=None, view=None, x__xgafv=None)</code>
+ <pre>Request a specific scan with Database-specific data for Cloud Key Visualizer.
+
+Args:
+ name: string, Required. The unique name of the scan containing the requested information, specific to the Database service implementing this interface. (required)
+ endTime: string, The upper bound for the time range to retrieve Scan data for.
+ startTime: string, These fields restrict the Database-specific information returned in the `Scan.data` field. If a `View` is provided that does not include the `Scan.data` field, these are ignored. This range of time must be entirely contained within the defined time range of the targeted scan. The lower bound for the time range to retrieve Scan data for.
+ view: string, Specifies which parts of the Scan should be returned in the response. Note, if left unspecified, the FULL view is assumed.
+ Allowed values
+ VIEW_UNSPECIFIED - Not specified, equivalent to SUMMARY.
+ SUMMARY - Server responses only include `name`, `details`, `start_time` and `end_time`. The default value. Note, the ListScans method may only use this view type, others view types are not supported.
+ FULL - Full representation of the scan is returned in the server response, including `data`.
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # Scan is a structure which describes Cloud Key Visualizer scan information.
+ "details": { # Additional information provided by the implementer.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "endTime": "A String", # The upper bound for when the scan is defined.
+ "name": "A String", # The unique name of the scan, specific to the Database service implementing this interface.
+ "scanData": { # ScanData contains Cloud Key Visualizer scan data used by the caller to construct a visualization. # Output only. Cloud Key Visualizer scan data. Note, this field is not available to the ListScans method.
+ "data": { # Cloud Key Visualizer scan data. The range of time this information covers is captured via the above time range fields. Note, this field is not available to the ListScans method.
+ "dataSourceEndToken": "A String", # The token signifying the end of a data_source.
+ "dataSourceSeparatorToken": "A String", # The token delimiting a datasource name from the rest of a key in a data_source.
+ "diagnosticMessages": [ # The list of messages (info, alerts, ...)
+ { # A message representing the key visualizer diagnostic messages.
+ "info": { # A message representing a user-facing string whose value may need to be translated before being displayed. # Information about this diagnostic information.
+ "args": { # A map of arguments used when creating the localized message. Keys represent parameter names which may be used by the localized version when substituting dynamic values.
+ "a_key": "A String",
+ },
+ "message": "A String", # The canonical English version of this message. If no token is provided or the front-end has no message associated with the token, this text will be displayed as-is.
+ "token": "A String", # The token identifying the message, e.g. 'METRIC_READ_CPU'. This should be unique within the service.
+ },
+ "metric": { # A message representing a user-facing string whose value may need to be translated before being displayed. # The metric.
+ "args": { # A map of arguments used when creating the localized message. Keys represent parameter names which may be used by the localized version when substituting dynamic values.
+ "a_key": "A String",
+ },
+ "message": "A String", # The canonical English version of this message. If no token is provided or the front-end has no message associated with the token, this text will be displayed as-is.
+ "token": "A String", # The token identifying the message, e.g. 'METRIC_READ_CPU'. This should be unique within the service.
+ },
+ "metricSpecific": True or False, # Whether this message is specific only for the current metric. By default Diagnostics are shown for all metrics, regardless which metric is the currently selected metric in the UI. However occasionally a metric will generate so many messages that the resulting visual clutter becomes overwhelming. In this case setting this to true, will show the diagnostic messages for that metric only if it is the currently selected metric.
+ "severity": "A String", # The severity of the diagnostic message.
+ "shortMessage": { # A message representing a user-facing string whose value may need to be translated before being displayed. # The short message.
+ "args": { # A map of arguments used when creating the localized message. Keys represent parameter names which may be used by the localized version when substituting dynamic values.
+ "a_key": "A String",
+ },
+ "message": "A String", # The canonical English version of this message. If no token is provided or the front-end has no message associated with the token, this text will be displayed as-is.
+ "token": "A String", # The token identifying the message, e.g. 'METRIC_READ_CPU'. This should be unique within the service.
+ },
+ },
+ ],
+ "endKeyStrings": [ # We discretize the entire keyspace into buckets. Assuming each bucket has an inclusive keyrange and covers keys from k(i) ... k(n). In this case k(n) would be an end key for a given range. end_key_string is the collection of all such end keys
+ "A String",
+ ],
+ "hasPii": True or False, # Whether this scan contains PII.
+ "indexedKeys": [ # Keys of key ranges that contribute significantly to a given metric Can be thought of as heavy hitters.
+ "A String",
+ ],
+ "keySeparator": "A String", # The token delimiting the key prefixes.
+ "keyUnit": "A String", # The unit for the key: e.g. 'key' or 'chunk'.
+ "metrics": [ # The list of data objects for each metric.
+ { # A message representing the actual monitoring data, values for each key bucket over time, of a metric.
+ "aggregation": "A String", # The aggregation function used to aggregate each key bucket
+ "category": { # A message representing a user-facing string whose value may need to be translated before being displayed. # The category of the metric, e.g. "Activity", "Alerts", "Reads", etc.
+ "args": { # A map of arguments used when creating the localized message. Keys represent parameter names which may be used by the localized version when substituting dynamic values.
+ "a_key": "A String",
+ },
+ "message": "A String", # The canonical English version of this message. If no token is provided or the front-end has no message associated with the token, this text will be displayed as-is.
+ "token": "A String", # The token identifying the message, e.g. 'METRIC_READ_CPU'. This should be unique within the service.
+ },
+ "derived": { # A message representing a derived metric. # The references to numerator and denominator metrics for a derived metric.
+ "denominator": { # A message representing a user-facing string whose value may need to be translated before being displayed. # The name of the denominator metric. e.g. "rows".
+ "args": { # A map of arguments used when creating the localized message. Keys represent parameter names which may be used by the localized version when substituting dynamic values.
+ "a_key": "A String",
+ },
+ "message": "A String", # The canonical English version of this message. If no token is provided or the front-end has no message associated with the token, this text will be displayed as-is.
+ "token": "A String", # The token identifying the message, e.g. 'METRIC_READ_CPU'. This should be unique within the service.
+ },
+ "numerator": { # A message representing a user-facing string whose value may need to be translated before being displayed. # The name of the numerator metric. e.g. "latency".
+ "args": { # A map of arguments used when creating the localized message. Keys represent parameter names which may be used by the localized version when substituting dynamic values.
+ "a_key": "A String",
+ },
+ "message": "A String", # The canonical English version of this message. If no token is provided or the front-end has no message associated with the token, this text will be displayed as-is.
+ "token": "A String", # The token identifying the message, e.g. 'METRIC_READ_CPU'. This should be unique within the service.
+ },
+ },
+ "displayLabel": { # A message representing a user-facing string whose value may need to be translated before being displayed. # The displayed label of the metric.
+ "args": { # A map of arguments used when creating the localized message. Keys represent parameter names which may be used by the localized version when substituting dynamic values.
+ "a_key": "A String",
+ },
+ "message": "A String", # The canonical English version of this message. If no token is provided or the front-end has no message associated with the token, this text will be displayed as-is.
+ "token": "A String", # The token identifying the message, e.g. 'METRIC_READ_CPU'. This should be unique within the service.
+ },
+ "hasNonzeroData": True or False, # Whether the metric has any non-zero data.
+ "hotValue": 3.14, # The value that is considered hot for the metric. On a per metric basis hotness signals high utilization and something that might potentially be a cause for concern by the end user. hot_value is used to calibrate and scale visual color scales.
+ "indexedHotKeys": { # The (sparse) mapping from time index to an IndexedHotKey message, representing those time intervals for which there are hot keys.
+ "a_key": { # A message representing a (sparse) collection of hot keys for specific key buckets.
+ "sparseHotKeys": { # A (sparse) mapping from key bucket index to the index of the specific hot row key for that key bucket. The index of the hot row key can be translated to the actual row key via the ScanData.VisualizationData.indexed_keys repeated field.
+ "a_key": 42,
+ },
+ },
+ },
+ "indexedKeyRangeInfos": { # The (sparse) mapping from time interval index to an IndexedKeyRangeInfos message, representing those time intervals for which there are informational messages concerning key ranges.
+ "a_key": { # A message representing a (sparse) collection of KeyRangeInfos for specific key buckets.
+ "keyRangeInfos": { # A (sparse) mapping from key bucket index to the KeyRangeInfos for that key bucket.
+ "a_key": { # A message representing a list of specific information for multiple key ranges.
+ "infos": [ # The list individual KeyRangeInfos.
+ { # A message representing information for a key range (possibly one key).
+ "contextValues": [ # The list of context values for this key range.
+ { # A message representing context for a KeyRangeInfo, including a label, value, unit, and severity.
+ "label": { # A message representing a user-facing string whose value may need to be translated before being displayed. # The label for the context value. e.g. "latency".
+ "args": { # A map of arguments used when creating the localized message. Keys represent parameter names which may be used by the localized version when substituting dynamic values.
+ "a_key": "A String",
+ },
+ "message": "A String", # The canonical English version of this message. If no token is provided or the front-end has no message associated with the token, this text will be displayed as-is.
+ "token": "A String", # The token identifying the message, e.g. 'METRIC_READ_CPU'. This should be unique within the service.
+ },
+ "severity": "A String", # The severity of this context.
+ "unit": "A String", # The unit of the context value.
+ "value": 3.14, # The value for the context.
+ },
+ ],
+ "endKeyIndex": 42, # The index of the end key in indexed_keys.
+ "info": { # A message representing a user-facing string whose value may need to be translated before being displayed. # Information about this key range, for all metrics.
+ "args": { # A map of arguments used when creating the localized message. Keys represent parameter names which may be used by the localized version when substituting dynamic values.
+ "a_key": "A String",
+ },
+ "message": "A String", # The canonical English version of this message. If no token is provided or the front-end has no message associated with the token, this text will be displayed as-is.
+ "token": "A String", # The token identifying the message, e.g. 'METRIC_READ_CPU'. This should be unique within the service.
+ },
+ "keysCount": "A String", # The number of keys this range covers.
+ "metric": { # A message representing a user-facing string whose value may need to be translated before being displayed. # The name of the metric. e.g. "latency".
+ "args": { # A map of arguments used when creating the localized message. Keys represent parameter names which may be used by the localized version when substituting dynamic values.
+ "a_key": "A String",
+ },
+ "message": "A String", # The canonical English version of this message. If no token is provided or the front-end has no message associated with the token, this text will be displayed as-is.
+ "token": "A String", # The token identifying the message, e.g. 'METRIC_READ_CPU'. This should be unique within the service.
+ },
+ "startKeyIndex": 42, # The index of the start key in indexed_keys.
+ "unit": { # A message representing a user-facing string whose value may need to be translated before being displayed. # The unit of the metric. This is an unstructured field and will be mapped as is to the user.
+ "args": { # A map of arguments used when creating the localized message. Keys represent parameter names which may be used by the localized version when substituting dynamic values.
+ "a_key": "A String",
+ },
+ "message": "A String", # The canonical English version of this message. If no token is provided or the front-end has no message associated with the token, this text will be displayed as-is.
+ "token": "A String", # The token identifying the message, e.g. 'METRIC_READ_CPU'. This should be unique within the service.
+ },
+ "value": 3.14, # The value of the metric.
+ },
+ ],
+ "totalSize": 42, # The total size of the list of all KeyRangeInfos. This may be larger than the number of repeated messages above. If that is the case, this number may be used to determine how many are not being shown.
+ },
+ },
+ },
+ },
+ "info": { # A message representing a user-facing string whose value may need to be translated before being displayed. # Information about the metric.
+ "args": { # A map of arguments used when creating the localized message. Keys represent parameter names which may be used by the localized version when substituting dynamic values.
+ "a_key": "A String",
+ },
+ "message": "A String", # The canonical English version of this message. If no token is provided or the front-end has no message associated with the token, this text will be displayed as-is.
+ "token": "A String", # The token identifying the message, e.g. 'METRIC_READ_CPU'. This should be unique within the service.
+ },
+ "matrix": { # A message representing a matrix of floats. # The data for the metric as a matrix.
+ "rows": [ # The rows of the matrix.
+ { # A message representing a row of a matrix of floats.
+ "cols": [ # The columns of the row.
+ 3.14,
+ ],
+ },
+ ],
+ },
+ "unit": { # A message representing a user-facing string whose value may need to be translated before being displayed. # The unit of the metric.
+ "args": { # A map of arguments used when creating the localized message. Keys represent parameter names which may be used by the localized version when substituting dynamic values.
+ "a_key": "A String",
+ },
+ "message": "A String", # The canonical English version of this message. If no token is provided or the front-end has no message associated with the token, this text will be displayed as-is.
+ "token": "A String", # The token identifying the message, e.g. 'METRIC_READ_CPU'. This should be unique within the service.
+ },
+ "visible": True or False, # Whether the metric is visible to the end user.
+ },
+ ],
+ "prefixNodes": [ # The list of extracted key prefix nodes used in the key prefix hierarchy.
+ { # A message representing a key prefix node in the key prefix hierarchy. for eg. Bigtable keyspaces are lexicographically ordered mappings of keys to values. Keys often have a shared prefix structure where users use the keys to organize data. Eg ///employee In this case Keysight will possibly use one node for a company and reuse it for all employees that fall under the company. Doing so improves legibility in the UI.
+ "dataSourceNode": True or False, # Whether this corresponds to a data_source name.
+ "depth": 42, # The depth in the prefix hierarchy.
+ "endIndex": 42, # The index of the end key bucket of the range that this node spans.
+ "startIndex": 42, # The index of the start key bucket of the range that this node spans.
+ "word": "A String", # The string represented by the prefix node.
+ },
+ ],
+ },
+ "endTime": "A String", # The upper bound for when the contained data is defined.
+ "startTime": "A String", # A range of time (inclusive) for when the contained data is defined. The lower bound for when the contained data is defined.
+ },
+ "startTime": "A String", # A range of time (inclusive) for when the scan is defined. The lower bound for when the scan is defined.
+}</pre>
+</div>
+
+<div class="method">
<code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
<pre>Lists Cloud Spanner databases.