Log
[application/vnd.com.chemcaster.Log+json]
A Log represents the set of changes made to a
Registry, and all of its
Registrations,
Queries, and
Archives
within a given time interval. A Log is typically used when synchronizing
multiple applications using the same Registry.
A Log has the following resources and attributes:
| Name
| Type
| Occurs
| Description
|
|---|
| log:created_at
| Datetime
| 1
| The time of creation for this Log.
|
| log:interval
| Number
| 1
| The number of seconds covered by this Log.
|
| registry
| Link
| 1
| The Registry covered by this Log.
|
| index
| Link
| 1
| The complete list of all Logs for this Registry.
|
| events
| [Event]
| 1
| List of all events occurring within a Registry in
reverse chronological order during the covered interval.
|
Sample Requests and Responses
Representations are transported
between client and server over HTTP using media types specific to
each resource. For details, see Common Behaviors.
Note: clients MUST NOT make assumptions about the layout of the URIs within the Service.
The following examples illustrate sample requests and responses.
View a Log
- Synopsis
- GET {URI of Log resource}
- Request Headers
- Accept, Authorization
- Request Message Body
- N/A
- Response Headers
- Content-Length, Content-Type
- Response Message Body
- [application/vnd.com.chemcaster.Log+json]
- Response Status
- 200, 401, 404, 406
Example Request
GET /registries/123/logs/2009091801
Host: chemcaster.com
Authorization: Basic xxxxxxxxxxxxxxxxxxx
Accept: application/vnd.com.chemcaster.Log+json
Example Response
HTTP/1.1 200 OK
Content-Type: application/vnd.com.chemcaster.Log+json
Content-Length: nnn
{
"log": {
"created_at": "Fri Sep 18 02:00:00 UTC 2009",
"interval": 3600
},
"registry": {
"name": "CarboBlox, Inc.",
"uri": "https:\/\/chemcaster.com\/registries\/815",
"media_type": "application\/vnd.com.chemcaster.Registry+json"
},
"index": {
"name": "all updates for the same registry",
"uri": "https:\/\/chemcaster.com\/registries\/815\/updates",
"media_type": "application\/vnd.com.chemcaster.Index+json"
},
"events": [
{
"resource": {
"name": "the modified resource",
"uri": "https:\/\/chemcaster.com\/registrations\/123",
"media_type": "application/vnd.com.chemcaster.Registration+json"
},
"logged_at": "Fri Sep 18 01:45:09 UTC 2009"
},
{
"resource": {
"name": "the modified resource",
"uri": "https:\/\/chemcaster.com\/registries\/12",
"media_type": "application/vnd.com.chemcaster.Registry+json"
},
"logged_at": "Fri Sep 18 01:22:06 UTC 2009"
},
{
"resource": {
"name": "the modified resource",
"uri": "https:\/\/chemcaster.com\/registrations\/54",
"media_type": "application/vnd.com.chemcaster.Registration+json"
},
"logged_at": "Fri Sep 18 01:15:01 UTC 2009"
},
{
"resource": {
"name": "the modified resource",
"uri": "https:\/\/chemcaster.com\/registrations\/42",
"media_type": "application/vnd.com.chemcaster.Registration+json"
},
"logged_at": "Fri Sep 18 01:09:00 UTC 2009"
}
]
}
This documentation is based in part on the
Sun Cloud API Documentation,
which was adapted under the
Creative Commons Attribution 3.0 Unported License.
