RAmbla Monitoring Service

From Rambla Wiki
Jump to: navigation, search

Introduction

The RAmbla Monitoring Service (RAMS) is a web service with a resource oriented architecture that can be accessed through a REST API. Its purpose is to provide a programmatic way for Rambla's customers to monitor statistic data about their media items. As such, it is a part of the RAmbla Web Services framework.

By conforming to the uniform HTTP interface for accessing online resources, RAMS accommodates rapid client application development in any programming language. The client application can be a standalone process, part of a CMS or anything else that can send and receive HTTP requests. Many programming language already include open-source libraries that implement some or all functionality necessary for creating a generic REST client application.

Design and Functionality

RAMS currently exposes a basic interface for the retrieval of information:

  • Retrieve traffic data for any file or directory on the CDN.
  • Retrieve the maximum amount of storage in use during a monthly period.
  • Retrieve information about the user account's traffic filters.

Requests are sent using the HTTP protocol and require HTTP Basic Authentication. Currently, all request information is contained inside the URI and the request headers. The result of a request is conveyed through standard HTTP header mechanisms and, additionally, via custom RAWS status codes and messages. As a rule, the response body (if present) will be encoded in the same format as the request, but the user can override this via the query-string part of the URI.

More Information

Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox