YARN-3539. Updated timeline server documentation and marked REST APIs evolving. Contributed by Steve Loughran.
This commit is contained in:
parent
2463666ecb
commit
fcd0702c10
|
@ -169,6 +169,7 @@ REST API compatibility corresponds to both the request (URLs) and responses to e
|
|||
* [NodeManager](../../hadoop-yarn/hadoop-yarn-site/NodeManagerRest.html)
|
||||
* [MR Application Master](../../hadoop-yarn/hadoop-yarn-site/MapredAppMasterRest.html)
|
||||
* [History Server](../../hadoop-yarn/hadoop-yarn-site/HistoryServerRest.html)
|
||||
* [Timeline Server v1 REST API](../../hadoop-yarn/hadoop-yarn-site/TimelineServer.html)
|
||||
|
||||
#### Policy
|
||||
|
||||
|
|
|
@ -134,6 +134,7 @@
|
|||
<item name="Introduction" href="hadoop-yarn/hadoop-yarn-site/WebServicesIntro.html"/>
|
||||
<item name="Resource Manager" href="hadoop-yarn/hadoop-yarn-site/ResourceManagerRest.html"/>
|
||||
<item name="Node Manager" href="hadoop-yarn/hadoop-yarn-site/NodeManagerRest.html"/>
|
||||
<item name="Timeline Server" href="TimelineServer.html#Timeline_Server_REST_API_v1"/>
|
||||
</menu>
|
||||
|
||||
<menu name="Hadoop Compatible File Systems" inherit="top">
|
||||
|
|
|
@ -414,6 +414,9 @@ Release 2.7.1 - UNRELEASED
|
|||
YARN-3489. RMServerUtils.validateResourceRequests should only obtain queue
|
||||
info once. (Varun Saxena via wangda)
|
||||
|
||||
YARN-3539. Updated timeline server documentation and marked REST APIs evolving.
|
||||
(Steve Loughran via zjshen)
|
||||
|
||||
OPTIMIZATIONS
|
||||
|
||||
BUG FIXES
|
||||
|
|
|
@ -24,7 +24,7 @@ import javax.xml.bind.annotation.XmlElement;
|
|||
import javax.xml.bind.annotation.XmlRootElement;
|
||||
|
||||
import org.apache.hadoop.classification.InterfaceAudience.Public;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Unstable;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Evolving;
|
||||
|
||||
/**
|
||||
* The response of delegation token related request
|
||||
|
@ -32,7 +32,7 @@ import org.apache.hadoop.classification.InterfaceStability.Unstable;
|
|||
@XmlRootElement(name = "delegationtoken")
|
||||
@XmlAccessorType(XmlAccessType.NONE)
|
||||
@Public
|
||||
@Unstable
|
||||
@Evolving
|
||||
public class TimelineDelegationTokenResponse {
|
||||
|
||||
private String type;
|
||||
|
|
|
@ -24,7 +24,7 @@ import javax.xml.bind.annotation.XmlElement;
|
|||
import javax.xml.bind.annotation.XmlRootElement;
|
||||
|
||||
import org.apache.hadoop.classification.InterfaceAudience.Public;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Unstable;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Evolving;
|
||||
|
||||
/**
|
||||
* <p>
|
||||
|
@ -43,7 +43,7 @@ import org.apache.hadoop.classification.InterfaceStability.Unstable;
|
|||
@XmlRootElement(name = "domain")
|
||||
@XmlAccessorType(XmlAccessType.NONE)
|
||||
@Public
|
||||
@Unstable
|
||||
@Evolving
|
||||
public class TimelineDomain {
|
||||
|
||||
private String id;
|
||||
|
|
|
@ -27,7 +27,7 @@ import javax.xml.bind.annotation.XmlElement;
|
|||
import javax.xml.bind.annotation.XmlRootElement;
|
||||
|
||||
import org.apache.hadoop.classification.InterfaceAudience.Public;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Unstable;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Evolving;
|
||||
|
||||
/**
|
||||
* The class that hosts a list of timeline domains.
|
||||
|
@ -35,7 +35,7 @@ import org.apache.hadoop.classification.InterfaceStability.Unstable;
|
|||
@XmlRootElement(name = "domains")
|
||||
@XmlAccessorType(XmlAccessType.NONE)
|
||||
@Public
|
||||
@Unstable
|
||||
@Evolving
|
||||
public class TimelineDomains {
|
||||
|
||||
private List<TimelineDomain> domains = new ArrayList<TimelineDomain>();
|
||||
|
|
|
@ -27,7 +27,7 @@ import javax.xml.bind.annotation.XmlElement;
|
|||
import javax.xml.bind.annotation.XmlRootElement;
|
||||
|
||||
import org.apache.hadoop.classification.InterfaceAudience.Public;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Unstable;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Evolving;
|
||||
|
||||
/**
|
||||
* The class that hosts a list of timeline entities.
|
||||
|
@ -35,7 +35,7 @@ import org.apache.hadoop.classification.InterfaceStability.Unstable;
|
|||
@XmlRootElement(name = "entities")
|
||||
@XmlAccessorType(XmlAccessType.NONE)
|
||||
@Public
|
||||
@Unstable
|
||||
@Evolving
|
||||
public class TimelineEntities {
|
||||
|
||||
private List<TimelineEntity> entities =
|
||||
|
|
|
@ -33,7 +33,7 @@ import javax.xml.bind.annotation.XmlRootElement;
|
|||
|
||||
import org.apache.hadoop.classification.InterfaceAudience.Private;
|
||||
import org.apache.hadoop.classification.InterfaceAudience.Public;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Unstable;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Evolving;
|
||||
|
||||
/**
|
||||
* <p>
|
||||
|
@ -52,7 +52,7 @@ import org.apache.hadoop.classification.InterfaceStability.Unstable;
|
|||
@XmlRootElement(name = "entity")
|
||||
@XmlAccessorType(XmlAccessType.NONE)
|
||||
@Public
|
||||
@Unstable
|
||||
@Evolving
|
||||
public class TimelineEntity implements Comparable<TimelineEntity> {
|
||||
|
||||
private String entityType;
|
||||
|
|
|
@ -28,7 +28,7 @@ import javax.xml.bind.annotation.XmlRootElement;
|
|||
|
||||
import org.apache.hadoop.classification.InterfaceAudience.Private;
|
||||
import org.apache.hadoop.classification.InterfaceAudience.Public;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Unstable;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Evolving;
|
||||
|
||||
/**
|
||||
* The class that contains the information of an event that is related to some
|
||||
|
@ -39,7 +39,7 @@ import org.apache.hadoop.classification.InterfaceStability.Unstable;
|
|||
@XmlRootElement(name = "event")
|
||||
@XmlAccessorType(XmlAccessType.NONE)
|
||||
@Public
|
||||
@Unstable
|
||||
@Evolving
|
||||
public class TimelineEvent implements Comparable<TimelineEvent> {
|
||||
|
||||
private long timestamp;
|
||||
|
|
|
@ -27,7 +27,7 @@ import javax.xml.bind.annotation.XmlElement;
|
|||
import javax.xml.bind.annotation.XmlRootElement;
|
||||
|
||||
import org.apache.hadoop.classification.InterfaceAudience.Public;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Unstable;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Evolving;
|
||||
|
||||
/**
|
||||
* The class that hosts a list of events, which are categorized according to
|
||||
|
@ -36,7 +36,7 @@ import org.apache.hadoop.classification.InterfaceStability.Unstable;
|
|||
@XmlRootElement(name = "events")
|
||||
@XmlAccessorType(XmlAccessType.NONE)
|
||||
@Public
|
||||
@Unstable
|
||||
@Evolving
|
||||
public class TimelineEvents {
|
||||
|
||||
private List<EventsOfOneEntity> allEvents =
|
||||
|
@ -93,7 +93,7 @@ public class TimelineEvents {
|
|||
@XmlRootElement(name = "events")
|
||||
@XmlAccessorType(XmlAccessType.NONE)
|
||||
@Public
|
||||
@Unstable
|
||||
@Evolving
|
||||
public static class EventsOfOneEntity {
|
||||
|
||||
private String entityId;
|
||||
|
|
|
@ -18,7 +18,7 @@
|
|||
package org.apache.hadoop.yarn.api.records.timeline;
|
||||
|
||||
import org.apache.hadoop.classification.InterfaceAudience.Public;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Unstable;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Evolving;
|
||||
|
||||
import javax.xml.bind.annotation.XmlAccessType;
|
||||
import javax.xml.bind.annotation.XmlAccessorType;
|
||||
|
@ -36,7 +36,7 @@ import java.util.List;
|
|||
@XmlRootElement(name = "response")
|
||||
@XmlAccessorType(XmlAccessType.NONE)
|
||||
@Public
|
||||
@Unstable
|
||||
@Evolving
|
||||
public class TimelinePutResponse {
|
||||
|
||||
private List<TimelinePutError> errors = new ArrayList<TimelinePutError>();
|
||||
|
@ -92,7 +92,7 @@ public class TimelinePutResponse {
|
|||
@XmlRootElement(name = "error")
|
||||
@XmlAccessorType(XmlAccessType.NONE)
|
||||
@Public
|
||||
@Unstable
|
||||
@Evolving
|
||||
public static class TimelinePutError {
|
||||
|
||||
/**
|
||||
|
|
|
@ -16,6 +16,8 @@
|
|||
* limitations under the License.
|
||||
*/
|
||||
@InterfaceAudience.Public
|
||||
@InterfaceStability.Evolving
|
||||
package org.apache.hadoop.yarn.api.records.timeline;
|
||||
import org.apache.hadoop.classification.InterfaceAudience;
|
||||
import org.apache.hadoop.classification.InterfaceStability;
|
||||
|
||||
|
|
|
@ -22,7 +22,7 @@ import java.io.IOException;
|
|||
|
||||
import org.apache.hadoop.classification.InterfaceAudience.Private;
|
||||
import org.apache.hadoop.classification.InterfaceAudience.Public;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Unstable;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Evolving;
|
||||
import org.apache.hadoop.security.UserGroupInformation;
|
||||
import org.apache.hadoop.security.token.Token;
|
||||
import org.apache.hadoop.service.AbstractService;
|
||||
|
@ -38,7 +38,7 @@ import org.apache.hadoop.yarn.security.client.TimelineDelegationTokenIdentifier;
|
|||
* number of conceptual entities.
|
||||
*/
|
||||
@Public
|
||||
@Unstable
|
||||
@Evolving
|
||||
public abstract class TimelineClient extends AbstractService {
|
||||
|
||||
/**
|
||||
|
|
|
@ -43,7 +43,7 @@ import org.apache.commons.cli.Options;
|
|||
import org.apache.commons.logging.Log;
|
||||
import org.apache.commons.logging.LogFactory;
|
||||
import org.apache.hadoop.classification.InterfaceAudience.Private;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Unstable;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Evolving;
|
||||
import org.apache.hadoop.conf.Configuration;
|
||||
import org.apache.hadoop.security.UserGroupInformation;
|
||||
import org.apache.hadoop.security.SecurityUtil;
|
||||
|
@ -83,7 +83,7 @@ import com.sun.jersey.client.urlconnection.HttpURLConnectionFactory;
|
|||
import com.sun.jersey.client.urlconnection.URLConnectionClientHandler;
|
||||
|
||||
@Private
|
||||
@Unstable
|
||||
@Evolving
|
||||
public class TimelineClientImpl extends TimelineClient {
|
||||
|
||||
private static final Log LOG = LogFactory.getLog(TimelineClientImpl.class);
|
||||
|
|
|
@ -16,6 +16,8 @@
|
|||
* limitations under the License.
|
||||
*/
|
||||
@InterfaceAudience.Public
|
||||
@InterfaceStability.Evolving
|
||||
package org.apache.hadoop.yarn.client.api.impl;
|
||||
import org.apache.hadoop.classification.InterfaceAudience;
|
||||
import org.apache.hadoop.classification.InterfaceStability;
|
||||
|
||||
|
|
|
@ -16,6 +16,8 @@
|
|||
* limitations under the License.
|
||||
*/
|
||||
@InterfaceAudience.Public
|
||||
@InterfaceStability.Evolving
|
||||
package org.apache.hadoop.yarn.client.api;
|
||||
import org.apache.hadoop.classification.InterfaceAudience;
|
||||
import org.apache.hadoop.classification.InterfaceStability;
|
||||
|
||||
|
|
|
@ -22,7 +22,7 @@ import java.io.IOException;
|
|||
|
||||
import org.apache.hadoop.classification.InterfaceAudience;
|
||||
import org.apache.hadoop.classification.InterfaceAudience.Public;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Unstable;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Evolving;
|
||||
import org.apache.hadoop.conf.Configuration;
|
||||
import org.apache.hadoop.io.Text;
|
||||
import org.apache.hadoop.security.token.Token;
|
||||
|
@ -31,7 +31,7 @@ import org.apache.hadoop.yarn.client.api.TimelineClient;
|
|||
import org.apache.hadoop.yarn.exceptions.YarnException;
|
||||
|
||||
@Public
|
||||
@Unstable
|
||||
@Evolving
|
||||
public class TimelineDelegationTokenIdentifier extends YARNDelegationTokenIdentifier {
|
||||
|
||||
public static final Text KIND_NAME = new Text("TIMELINE_DELEGATION_TOKEN");
|
||||
|
|
|
@ -23,14 +23,14 @@ import java.util.Collection;
|
|||
import org.apache.commons.logging.Log;
|
||||
import org.apache.commons.logging.LogFactory;
|
||||
import org.apache.hadoop.classification.InterfaceAudience.Public;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Unstable;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Evolving;
|
||||
import org.apache.hadoop.io.Text;
|
||||
import org.apache.hadoop.security.token.Token;
|
||||
import org.apache.hadoop.security.token.TokenIdentifier;
|
||||
import org.apache.hadoop.security.token.TokenSelector;
|
||||
|
||||
@Public
|
||||
@Unstable
|
||||
@Evolving
|
||||
public class TimelineDelegationTokenSelector
|
||||
implements TokenSelector<TimelineDelegationTokenIdentifier> {
|
||||
|
||||
|
|
|
@ -22,9 +22,14 @@ import javax.xml.bind.annotation.XmlAccessType;
|
|||
import javax.xml.bind.annotation.XmlAccessorType;
|
||||
import javax.xml.bind.annotation.XmlRootElement;
|
||||
|
||||
import org.apache.hadoop.classification.InterfaceAudience.Public;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Evolving;
|
||||
|
||||
import org.apache.hadoop.yarn.api.records.ApplicationAttemptReport;
|
||||
import org.apache.hadoop.yarn.api.records.YarnApplicationAttemptState;
|
||||
|
||||
@Public
|
||||
@Evolving
|
||||
@XmlRootElement(name = "appAttempt")
|
||||
@XmlAccessorType(XmlAccessType.FIELD)
|
||||
public class AppAttemptInfo {
|
||||
|
|
|
@ -24,6 +24,11 @@ import javax.xml.bind.annotation.XmlAccessorType;
|
|||
import javax.xml.bind.annotation.XmlElement;
|
||||
import javax.xml.bind.annotation.XmlRootElement;
|
||||
|
||||
import org.apache.hadoop.classification.InterfaceAudience.Public;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Evolving;
|
||||
|
||||
@Public
|
||||
@Evolving
|
||||
@XmlRootElement(name = "appAttempts")
|
||||
@XmlAccessorType(XmlAccessType.FIELD)
|
||||
public class AppAttemptsInfo {
|
||||
|
|
|
@ -24,11 +24,16 @@ import javax.xml.bind.annotation.XmlAccessType;
|
|||
import javax.xml.bind.annotation.XmlAccessorType;
|
||||
import javax.xml.bind.annotation.XmlRootElement;
|
||||
|
||||
import org.apache.hadoop.classification.InterfaceAudience.Public;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Evolving;
|
||||
|
||||
import org.apache.hadoop.yarn.api.records.ApplicationReport;
|
||||
import org.apache.hadoop.yarn.api.records.FinalApplicationStatus;
|
||||
import org.apache.hadoop.yarn.api.records.YarnApplicationState;
|
||||
import org.apache.hadoop.yarn.util.Times;
|
||||
|
||||
@Public
|
||||
@Evolving
|
||||
@XmlRootElement(name = "app")
|
||||
@XmlAccessorType(XmlAccessType.FIELD)
|
||||
public class AppInfo {
|
||||
|
|
|
@ -17,17 +17,22 @@
|
|||
*/
|
||||
package org.apache.hadoop.yarn.server.webapp.dao;
|
||||
|
||||
import org.apache.hadoop.classification.InterfaceAudience.Public;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Evolving;
|
||||
|
||||
import java.util.ArrayList;
|
||||
|
||||
import javax.xml.bind.annotation.XmlAccessType;
|
||||
import javax.xml.bind.annotation.XmlAccessorType;
|
||||
import javax.xml.bind.annotation.XmlRootElement;
|
||||
|
||||
@Public
|
||||
@Evolving
|
||||
@XmlRootElement(name = "apps")
|
||||
@XmlAccessorType(XmlAccessType.FIELD)
|
||||
public class AppsInfo {
|
||||
|
||||
protected ArrayList<AppInfo> app = new ArrayList<AppInfo>();
|
||||
protected ArrayList<AppInfo> app = new ArrayList<>();
|
||||
|
||||
public AppsInfo() {
|
||||
// JAXB needs this
|
||||
|
|
|
@ -22,10 +22,15 @@ import javax.xml.bind.annotation.XmlAccessType;
|
|||
import javax.xml.bind.annotation.XmlAccessorType;
|
||||
import javax.xml.bind.annotation.XmlRootElement;
|
||||
|
||||
import org.apache.hadoop.classification.InterfaceAudience.Public;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Evolving;
|
||||
|
||||
import org.apache.hadoop.yarn.api.records.ContainerReport;
|
||||
import org.apache.hadoop.yarn.api.records.ContainerState;
|
||||
import org.apache.hadoop.yarn.util.Times;
|
||||
|
||||
@Public
|
||||
@Evolving
|
||||
@XmlRootElement(name = "container")
|
||||
@XmlAccessorType(XmlAccessType.FIELD)
|
||||
public class ContainerInfo {
|
||||
|
|
|
@ -23,6 +23,11 @@ import javax.xml.bind.annotation.XmlAccessType;
|
|||
import javax.xml.bind.annotation.XmlAccessorType;
|
||||
import javax.xml.bind.annotation.XmlRootElement;
|
||||
|
||||
import org.apache.hadoop.classification.InterfaceAudience.Public;
|
||||
import org.apache.hadoop.classification.InterfaceStability.Evolving;
|
||||
|
||||
@Public
|
||||
@Evolving
|
||||
@XmlRootElement(name = "containers")
|
||||
@XmlAccessorType(XmlAccessType.FIELD)
|
||||
public class ContainersInfo {
|
||||
|
|
File diff suppressed because it is too large
Load Diff
Loading…
Reference in New Issue