Cloud Spanner API . scans

Instance Methods

close()

Close httplib2 connections.

list(parent, filter=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)

Return available scans given a Database-specific resource name.

list_next()

Retrieves the next page of results.

Method Details

close()
Close httplib2 connections.
list(parent, filter=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)
Return available scans given a Database-specific resource name.

Args:
  parent: string, Required. The unique name of the parent resource, specific to the Database service implementing this interface. (required)
  filter: string, A filter expression to restrict the results based on information present in the available Scan collection. The filter applies to all fields within the Scan message except for `data`.
  pageSize: integer, The maximum number of items to return.
  pageToken: string, The next_page_token value returned from a previous List request, if any.
  view: string, Specifies which parts of the Scan should be returned in the response. Note, only the SUMMARY view (the default) is currently supported for ListScans.
    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:

    { # Response method from the ListScans method.
  "nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no more results in the list.
  "scans": [ # Available scans based on the list query parameters.
    { # 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.
                          "timeOffset": "A String", # The time offset. This is the time since the start of the time interval.
                          "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.
    },
  ],
}
list_next()
Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call 'execute()' on to request the next
          page. Returns None if there are no more items in the collection.