Note

See http://docs.openstack.org/developer/ceilometer/ for updated versions of this documentation.

Web API

GET /v1/resources

Return a list of all known resources.

Parameters:

• start_timestamp (ISO date in UTC) – Limits resources by last update time >= this value. (optional)
• end_timestamp (ISO date in UTC) – Limits resources by last update time < this value. (optional)

GET /v1/projects

Return a list of all known project names.

GET /v1/users

Return a list of all known user names.

GET /v1/resources/(resource)/meters/(meter)/volume/max

Return the max volume for a meter.

Parameters:

• resource – The ID of the resource.
• meter – The name of the meter.
• start_timestamp – ISO-formatted string of the earliest time to include in the calculation.
• end_timestamp – ISO-formatted string of the latest time to include in the calculation.
• search_offset – Number of minutes before and after start and end timestamps to query.

GET /v1/resources/(resource)/meters/(meter)/volume/sum

Return the total volume for a meter.

Parameters:

• resource – The ID of the resource.
• meter – The name of the meter.
• start_timestamp – ISO-formatted string of the earliest time to include in the calculation.
• end_timestamp – ISO-formatted string of the latest time to include in the calculation.
• search_offset – Number of minutes before and after start and end timestamps to query.

GET /v1/projects/(project)/meters/(meter)/volume/max

Return the max volume for a meter.

Parameters:

• project – The ID of the project.
• meter – The name of the meter.
• start_timestamp – ISO-formatted string of the earliest time to include in the calculation.
• end_timestamp – ISO-formatted string of the latest time to include in the calculation.
• search_offset – Number of minutes before and after start and end timestamps to query.

GET /v1/projects/(project)/meters/(meter)/volume/sum

Return the total volume for a meter.

Parameters:

• project – The ID of the project.
• meter – The name of the meter.
• start_timestamp – ISO-formatted string of the earliest time to include in the calculation.
• end_timestamp – ISO-formatted string of the latest time to include in the calculation.
• search_offset – Number of minutes before and after start and end timestamps to query.

GET /v1/resources/(resource)/meters/(meter)/duration

Return the earliest timestamp, last timestamp, and duration for the resource and meter.

Parameters:

• resource – The ID of the resource.
• meter – The name of the meter.
• start_timestamp – ISO-formatted string of the earliest timestamp to return.
• end_timestamp – ISO-formatted string of the latest timestamp to return.
• search_offset – Number of minutes before and after start and end timestamps to query.

GET /v1/resources/(resource)/meters/(meter)

Return a list of raw metering events for the resource.

Parameters:

• resource – The ID of the resource.
• meter – The name of the meter.
• start_timestamp (ISO date in UTC) – Limits events by timestamp >= this value. (optional)
• end_timestamp (ISO date in UTC) – Limits events by timestamp < this value. (optional)

GET /v1/projects/(project)/meters/(meter)

Return a list of raw metering events for the project.

Parameters:

• project – The ID of the project.
• meter – The name of the meter.
• start_timestamp (ISO date in UTC) – Limits events by timestamp >= this value. (optional)
• end_timestamp (ISO date in UTC) – Limits events by timestamp < this value. (optional)

GET /v1/sources/(source)/meters/(meter)

Return a list of raw metering events for the source.

Parameters:

• source – The ID of the reporting source.
• meter – The name of the meter.
• start_timestamp (ISO date in UTC) – Limits events by timestamp >= this value. (optional)
• end_timestamp (ISO date in UTC) – Limits events by timestamp < this value. (optional)

GET /v1/users/(user)/meters/(meter)

Return a list of raw metering events for the user.

Parameters:

• user – The ID of the user.
• meter – The name of the meter.
• start_timestamp (ISO date in UTC) – Limits events by timestamp >= this value. (optional)
• end_timestamp (ISO date in UTC) – Limits events by timestamp < this value. (optional)

GET /v1/projects/(project)/resources

Return a list of resources owned by the project.

Parameters:

• project – The ID of the owning project.
• start_timestamp (ISO date in UTC) – Limits resources by last update time >= this value. (optional)
• end_timestamp (ISO date in UTC) – Limits resources by last update time < this value. (optional)

GET /v1/sources/(source)/resources

Return a list of resources for which a source is reporting data.

Parameters:

• source – The ID of the reporting source.
• start_timestamp (ISO date in UTC) – Limits resources by last update time >= this value. (optional)
• end_timestamp (ISO date in UTC) – Limits resources by last update time < this value. (optional)

GET /v1/sources/(source)/projects

Return a list project names for which the source is reporting data.

Parameters:

• source – The ID of the source.

GET /v1/sources/(source)/users

Return a list of the users for which the source is reporting data.

Parameters:

• source – The ID of the source.

GET /v1/users/(user)/resources

Return a list of resources owned by the user.

Parameters:

• user – The ID of the owning user.
• start_timestamp (ISO date in UTC) – Limits resources by last update time >= this value. (optional)
• end_timestamp (ISO date in UTC) – Limits resources by last update time < this value. (optional)