CES API

The Cloud Eye Service Class

The CES high-level interface is available through the ces member of a Connection object. The ces member will only be added if the otcextensions.sdk.register_otc_extensions(conn) method is called.

Alarm Rule Operations

class otcextensions.sdk.ces.v1._proxy.Proxy(session, statsd_client=None, statsd_prefix=None, prometheus_counter=None, prometheus_histogram=None, influxdb_config=None, influxdb_client=None, *args, **kwargs)
alarms(**query)

Return a generator of alarms

Parameters:

query (dict) – Optional query parameters to be sent to limit the resources being returned.

Returns:

A generator of alarm objects

Return type:

Alarm

get_alarm(alarm)

Return a single alarm

Parameters:

alarm – The value can be the ID of a alarm or a Alarm instance.

Returns:

A generator of alarm objects

Return type:

Alarm

create_alarm(**attrs)

Create a new Alarm from attributes

Parameters:

attrs (dict) – Keyword arguments which will be used to create a otcextensions.sdk.ces.v1.alarm.Alarm

delete_alarm(alarm, ignore_missing=True)

Delete a Alarm

Parameters:
  • alarm – key id or an instance of otcextensions.sdk.ces.v1.alarm.Alarm

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the alarm does not exist. When set to True, no exception will be set when attempting to delete a nonexistent alarm.

Returns:

Alarm been deleted

Return type:

otcextensions.sdk.ces.v1.alarm.Alarm

find_alarm(name_or_id, ignore_missing=True)

Find a single alarm

Parameters:
  • name_or_id – The name or ID of a alarm

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the alarm does not exist. When set to True, no exception will be set when attempting to delete a nonexistent alarm.

Returns:

None

switch_alarm_state(alarm)

Enables or disables Alarm

Parameters:

alarm – The value can be the ID of an alarm or a Alarm instance.

Returns:

None

Monitoring Data Operations

class otcextensions.sdk.ces.v1._proxy.Proxy(session, statsd_client=None, statsd_prefix=None, prometheus_counter=None, prometheus_histogram=None, influxdb_config=None, influxdb_client=None, *args, **kwargs)
metric_data(**query)

Return a generator of Metric Data

Parameters:

query (kwargs) – Optional query parameters to be sent to limit the resources being returned.

Returns:

A generator of metric data objects

Return type:

MetricData

Miscellaneous Operations

class otcextensions.sdk.ces.v1._proxy.Proxy(session, statsd_client=None, statsd_prefix=None, prometheus_counter=None, prometheus_histogram=None, influxdb_config=None, influxdb_client=None, *args, **kwargs)
event_data(**query)
Return a generator of host configurations for a specified

event type in a specified period of time.

Parameters:

query (kwargs) – Optional query parameters to be sent to limit the resources being returned.

Returns:

A generator of event data objects

Return type:

EventData

metrics(**query)

Return a generator of metrics

Parameters:

query (kwargs) – Optional query parameters to be sent to limit the resources being returned.

Returns:

A generator of metric objects

Return type:

Metric

quotas()

Return a generator of quotas

Returns:

A generator of quota objects

Return type:

Quota