org.apache.hadoop.yarn.client.api
Class TimelineClient

java.lang.Object
  org.apache.hadoop.service.AbstractService
      org.apache.hadoop.yarn.client.api.TimelineClient

All Implemented Interfaces:

Closeable, Service

@InterfaceAudience.Public
@InterfaceStability.Unstable
public abstract class TimelineClient
extends AbstractService

A client library that can be used to post some information in terms of a number of conceptual entities.

Constructor Summary

protected

TimelineClient(String name)

Method Summary

abstract void	cancelDelegationToken(org.apache.hadoop.security.token.Token<TimelineDelegationTokenIdentifier> timelineDT) Cancel a timeline delegation token.
static TimelineClient	createTimelineClient()
abstract org.apache.hadoop.security.token.Token<TimelineDelegationTokenIdentifier>	getDelegationToken(String renewer) Get a delegation token so as to be able to talk to the timeline server in a secure way.
abstract void	putDomain(TimelineDomain domain) Send the information of a domain to the timeline server.
abstract TimelinePutResponse	putEntities(TimelineEntity... entities) Send the information of a number of conceptual entities to the timeline server.
abstract long	renewDelegationToken(org.apache.hadoop.security.token.Token<TimelineDelegationTokenIdentifier> timelineDT) Renew a timeline delegation token.

Methods inherited from class org.apache.hadoop.service.AbstractService

close, getBlockers, getConfig, getFailureCause, getFailureState, getLifecycleHistory, getName, getServiceState, getStartTime, init, isInState, noteFailure, putBlocker, registerGlobalListener, registerServiceListener, removeBlocker, serviceInit, serviceStart, serviceStop, setConfig, start, stop, toString, unregisterGlobalListener, unregisterServiceListener, waitForServiceToStop

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

TimelineClient

@InterfaceAudience.Private
protected TimelineClient(String name)

Method Detail

createTimelineClient

@InterfaceAudience.Public
public static TimelineClient createTimelineClient()

putEntities

@InterfaceAudience.Public
public abstract TimelinePutResponse putEntities(TimelineEntity... entities)
                                         throws IOException,
                                                YarnException

Send the information of a number of conceptual entities to the timeline server. It is a blocking API. The method will not return until it gets the response from the timeline server.

Parameters:

entities - the collection of TimelineEntity

Returns:

the error information if the sent entities are not correctly stored

Throws:

IOException

YarnException

putDomain

@InterfaceAudience.Public
public abstract void putDomain(TimelineDomain domain)
                        throws IOException,
                               YarnException

Send the information of a domain to the timeline server. It is a blocking API. The method will not return until it gets the response from the timeline server.

Parameters:

domain - an TimelineDomain object

Throws:

IOException

YarnException

getDelegationToken

@InterfaceAudience.Public
public abstract org.apache.hadoop.security.token.Token<TimelineDelegationTokenIdentifier> getDelegationToken(String renewer)
                                                                                                      throws IOException,
                                                                                                             YarnException

Get a delegation token so as to be able to talk to the timeline server in a secure way.

Parameters:

renewer - Address of the renewer who can renew these tokens when needed by securely talking to the timeline server

Returns:

a delegation token (Token) that can be used to talk to the timeline server

Throws:

IOException

YarnException

renewDelegationToken

@InterfaceAudience.Public
public abstract long renewDelegationToken(org.apache.hadoop.security.token.Token<TimelineDelegationTokenIdentifier> timelineDT)
                                   throws IOException,
                                          YarnException

Renew a timeline delegation token.

Parameters:

timelineDT - the delegation token to renew

Returns:

the new expiration time

Throws:

IOException

YarnException

cancelDelegationToken

@InterfaceAudience.Public
public abstract void cancelDelegationToken(org.apache.hadoop.security.token.Token<TimelineDelegationTokenIdentifier> timelineDT)
                                    throws IOException,
                                           YarnException

Cancel a timeline delegation token.

Parameters:

timelineDT - the delegation token to cancel

Throws:

IOException

YarnException