YARN-5843. Incorrect documentation for timeline service entityType/events REST end points (Bibin A Chundatt via Varun Saxena)

This commit is contained in:
Varun Saxena 2016-11-10 12:10:03 +05:30
parent c202a10923
commit c8bc7a8475
1 changed files with 9 additions and 12 deletions

View File

@ -632,7 +632,7 @@ Use the following URI to obtain all the entity objects of a given
### HTTP Operations Supported: ### HTTP Operations Supported:
GET http://localhost:8188/ws/v1/timeline/DS_APP_ATTEMPT GET
### Query Parameters Supported: ### Query Parameters Supported:
@ -687,7 +687,7 @@ will be returned as a collection of container objects. See also
HTTP Request: HTTP Request:
GET http://<timeline server http address:port>/ws/v1/timeline/{entity-type} GET http://localhost:8188/ws/v1/timeline/DS_APP_ATTEMPT
Response Header: Response Header:
@ -795,7 +795,7 @@ String.
HTTP Request: HTTP Request:
GET http://<timeline server http address:port>/ws/v1/timeline/{entity-type}/{entity-id} GET http://localhost:8188/ws/v1/timeline/DS_APP_ATTEMPT/appattempt_1430424020775_0003_000001
Response Header: Response Header:
@ -805,8 +805,6 @@ Response Header:
Response Body: Response Body:
http://localhost:8188/ws/v1/timeline/DS_APP_ATTEMPT/appattempt_1430424020775_0003_000001
{ {
"events":[ "events":[
{ {
@ -847,15 +845,17 @@ Use the following URI to obtain the event objects of the given `entityType`.
### Query Parameters Supported: ### Query Parameters Supported:
1. `entityIds` - The entity IDs to retrieve events for. 1. `entityId` - The entity IDs to retrieve events for. If null, no events will be returned.
Multiple entityIds can be given as comma separated values.
1. `limit` - A limit on the number of events to return for each entity. If null, 1. `limit` - A limit on the number of events to return for each entity. If null,
defaults to 100 events per entity. defaults to 100 events per entity.
1. `windowStart` - If not null, retrieves only events later than the given time 1. `windowStart` - If not null, retrieves only events later than the given time
(exclusive) (exclusive)
1. `windowEnd` - If not null, retrieves only events earlier than the given time 1. `windowEnd` - If not null, retrieves only events earlier than the given time
(inclusive) (inclusive)
1. `eventTypes` - Restricts the events returned to the given types. If null, 1. `eventType` - Restricts the events returned to the given types. If null,
events of all types will be returned. events of all types will be returned. Multiple eventTypes can be given as
comma separated values.
### Elements of the `events` (Timeline Entity List) Object ### Elements of the `events` (Timeline Entity List) Object
@ -882,7 +882,7 @@ Below is the elements of a single event object. Note that `value` of
HTTP Request: HTTP Request:
GET http://<timeline server http address:port>/ws/v1/timeline/entity%20type%200/events GET http://localhost:8188/ws/v1/timeline/DS_APP_ATTEMPT/events?entityId=appattempt_1430424020775_0003_000001
Response Header: Response Header:
@ -893,9 +893,6 @@ Response Header:
Response Body: Response Body:
GET http://localhost:8188/ws/v1/timeline/DS_APP_ATTEMPT/events?entityId=appattempt_1430424020775_0003_000001
{ {
"events": [ "events": [
{ {