YARN-805. Fix javadoc and annotations on classes in the yarn-api package. Contributed by Jian He.

git-svn-id: https://svn.apache.org/repos/asf/hadoop/common/trunk@1493992 13f79535-47bb-0310-9956-ffa450edef68

hadoop-mapreduce-project/hadoop-mapreduce-client/hadoop-mapreduce-client-app/src/main/java/org/apache/hadoop/mapreduce/v2/app/rm/RMContainerRequestor.java

@@ -241,7 +241,7 @@ public abstract class RMContainerRequestor extends RMCommunicator {
               ResourceRequest zeroedRequest =
                   ResourceRequest.newInstance(req.getPriority(),
                     req.getResourceName(), req.getCapability(),
-                    req.getNumContainers());
+                    req.getNumContainers(), req.getRelaxLocality());
 
               zeroedRequest.setNumContainers(0);
               // to be sent to RM on next heartbeat

hadoop-mapreduce-project/hadoop-mapreduce-client/hadoop-mapreduce-client-app/src/test/java/org/apache/hadoop/mapreduce/v2/app/TestRMContainerAllocator.java

@@ -1219,7 +1219,7 @@ public class TestRMContainerAllocator {
       for (ResourceRequest req : ask) {
         ResourceRequest reqCopy = ResourceRequest.newInstance(req
             .getPriority(), req.getResourceName(), req.getCapability(), req
-            .getNumContainers());
+            .getNumContainers(), req.getRelaxLocality());
         askCopy.add(reqCopy);
       }
       lastAsk = ask;

hadoop-yarn-project/CHANGES.txt

@@ -406,6 +406,9 @@ Release 2.1.0-beta - UNRELEASED
     YARN-833. Moved Graph and VisualizeStateMachine into yarn.state package.
     (Zhijie Shen via vinodkv)
 
+    YARN-805. Fix javadoc and annotations on classes in the yarn-api
+    package. (Jian He via sseth)
+
   OPTIMIZATIONS
 
     YARN-512. Log aggregation root directory check is more expensive than it

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/ApplicationClientProtocol.java

@@ -23,6 +23,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.Stable;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.CancelDelegationTokenRequest;
 import org.apache.hadoop.yarn.api.protocolrecords.CancelDelegationTokenResponse;
 import org.apache.hadoop.yarn.api.protocolrecords.GetAllApplicationsRequest;
@@ -73,7 +74,7 @@ public interface ApplicationClientProtocol {
    * a new application.</p>
    *
    * <p>The <code>ResourceManager</code> also responds with details such 
-   * as minimum and maximum resource capabilities in the cluster as specified in
+   * as maximum resource capabilities in the cluster as specified in
    * {@link GetNewApplicationResponse}.</p>
    *
    * @param request request to get a new <code>ApplicationId</code>
@@ -83,6 +84,8 @@ public interface ApplicationClientProtocol {
    * @throws IOException
    * @see #submitApplication(SubmitApplicationRequest)
    */
+  @Public
+  @Stable
   public GetNewApplicationResponse getNewApplication(
       GetNewApplicationRequest request)
   throws YarnException, IOException;
@@ -112,6 +115,8 @@ public interface ApplicationClientProtocol {
    * @throws IOException
    * @see #getNewApplication(GetNewApplicationRequest)
    */
+  @Public
+  @Stable
   public SubmitApplicationResponse submitApplication(
       SubmitApplicationRequest request) 
   throws YarnException, IOException;
@@ -129,13 +134,15 @@ public interface ApplicationClientProtocol {
    * <p>Currently, the <code>ResourceManager</code> returns an empty response
    * on success and throws an exception on rejecting the request.</p>
    * 
-   * @param request request to abort a submited application
+   * @param request request to abort a submitted application
    * @return <code>ResourceManager</code> returns an empty response
    *         on success and throws an exception on rejecting the request
    * @throws YarnException
    * @throws IOException
    * @see #getQueueUserAcls(GetQueueUserAclsInfoRequest) 
    */
+  @Public
+  @Stable
   public KillApplicationResponse forceKillApplication(
       KillApplicationRequest request) 
   throws YarnException, IOException;
@@ -171,6 +178,8 @@ public interface ApplicationClientProtocol {
    * @throws YarnException
    * @throws IOException
    */
+  @Public
+  @Stable
   public GetApplicationReportResponse getApplicationReport(
       GetApplicationReportRequest request) 
   throws YarnException, IOException;
@@ -189,6 +198,8 @@ public interface ApplicationClientProtocol {
    * @throws YarnException
    * @throws IOException
    */
+  @Public
+  @Stable
   public GetClusterMetricsResponse getClusterMetrics(
       GetClusterMetricsRequest request) 
   throws YarnException, IOException;
@@ -211,6 +222,8 @@ public interface ApplicationClientProtocol {
    * @throws YarnException
    * @throws IOException
    */
+  @Public
+  @Stable
   public GetAllApplicationsResponse getAllApplications(
       GetAllApplicationsRequest request) 
   throws YarnException, IOException;
@@ -228,6 +241,8 @@ public interface ApplicationClientProtocol {
    * @throws YarnException
    * @throws IOException
    */
+  @Public
+  @Stable
   public GetClusterNodesResponse getClusterNodes(
       GetClusterNodesRequest request) 
   throws YarnException, IOException;
@@ -247,6 +262,8 @@ public interface ApplicationClientProtocol {
    * @throws YarnException
    * @throws IOException
    */
+  @Public
+  @Stable
   public GetQueueInfoResponse getQueueInfo(
       GetQueueInfoRequest request) 
   throws YarnException, IOException;
@@ -264,6 +281,8 @@ public interface ApplicationClientProtocol {
    * @throws YarnException
    * @throws IOException
    */
+  @Public
+  @Stable
   public GetQueueUserAclsInfoResponse getQueueUserAcls(
       GetQueueUserAclsInfoRequest request) 
   throws YarnException, IOException;
@@ -272,7 +291,7 @@ public interface ApplicationClientProtocol {
    * <p>The interface used by clients to get delegation token, enabling the 
    * containers to be able to talk to the service using those tokens.
    * 
-   *  <p> The <code>ResourceManager</code> responds with the delegation token
+   *  <p> The <code>ResourceManager</code> responds with the delegation
    *  {@link Token} that can be used by the client to speak to this
    *  service.
    * @param request request to get a delegation token for the client.
@@ -280,12 +299,14 @@ public interface ApplicationClientProtocol {
    * @throws YarnException
    * @throws IOException
    */
+  @Public
+  @Stable
   public GetDelegationTokenResponse getDelegationToken(
       GetDelegationTokenRequest request) 
   throws YarnException, IOException;
   
   /**
-   * Renew an existing delegation token.
+   * Renew an existing delegation {@link Token}.
    * 
    * @param request the delegation token to be renewed.
    * @return the new expiry time for the delegation token.
@@ -293,12 +314,13 @@ public interface ApplicationClientProtocol {
    * @throws IOException
    */
   @Private
+  @Unstable
   public RenewDelegationTokenResponse renewDelegationToken(
       RenewDelegationTokenRequest request) throws YarnException,
       IOException;
 
   /**
-   * Cancel an existing delegation token.
+   * Cancel an existing delegation {@link Token}.
    * 
    * @param request the delegation token to be cancelled.
    * @return an empty response.
@@ -306,6 +328,7 @@ public interface ApplicationClientProtocol {
    * @throws IOException
    */
   @Private
+  @Unstable
   public CancelDelegationTokenResponse cancelDelegationToken(
       CancelDelegationTokenRequest request) throws YarnException,
       IOException;

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/ApplicationClientProtocolPB.java

@@ -17,9 +17,13 @@
  */
 package org.apache.hadoop.yarn.api;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.ipc.ProtocolInfo;
 import org.apache.hadoop.yarn.proto.ApplicationClientProtocol.ApplicationClientProtocolService;
 
+@Private
+@Unstable
 @ProtocolInfo(protocolName = "org.apache.hadoop.yarn.api.ApplicationClientProtocolPB",
     protocolVersion = 1)
 public interface ApplicationClientProtocolPB extends ApplicationClientProtocolService.BlockingInterface {

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/ApplicationConstants.java

@@ -18,6 +18,8 @@
 
 package org.apache.hadoop.yarn.api;
 
+import org.apache.hadoop.classification.InterfaceAudience.Public;
+import org.apache.hadoop.classification.InterfaceStability.Evolving;
 import org.apache.hadoop.security.UserGroupInformation;
 import org.apache.hadoop.util.Shell;
 
@@ -27,6 +29,8 @@ import org.apache.hadoop.util.Shell;
  * 
  * TODO: Investigate the semantics and security of each cross-boundary refs.
  */
+@Public
+@Evolving
 public interface ApplicationConstants {
   
   /**
@@ -35,6 +39,9 @@ public interface ApplicationConstants {
    */
   public static final String APP_SUBMIT_TIME_ENV = "APP_SUBMIT_TIME_ENV";
 
+  /**
+   * The cache file into which container token is written
+   */
   public static final String CONTAINER_TOKEN_FILE_ENV_NAME =
       UserGroupInformation.HADOOP_TOKEN_FILE_LOCATION;
 
@@ -46,6 +53,10 @@ public interface ApplicationConstants {
   public static final String APPLICATION_WEB_PROXY_BASE_ENV = 
     "APPLICATION_WEB_PROXY_BASE";
 
+  /**
+   * The temporary environmental variable for container log directory. This
+   * should be replaced by real container log directory on container launch.
+   */
   public static final String LOG_DIR_EXPANSION_VAR = "<LOG_DIR>";
 
   public static final String STDERR = "stderr";

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/ApplicationMasterProtocol.java

@@ -54,7 +54,7 @@ public interface ApplicationMasterProtocol {
    * {@link RegisterApplicationMasterRequest}.</p>
    * 
    * <p>The <code>ResourceManager</code> responds with critical details such 
-   * as minimum and maximum resource capabilities in the cluster as specified in
+   * as maximum resource capabilities in the cluster as specified in
    * {@link RegisterApplicationMasterResponse}.</p>
    *  
    * @param request registration request
@@ -64,6 +64,8 @@ public interface ApplicationMasterProtocol {
    * @see RegisterApplicationMasterRequest
    * @see RegisterApplicationMasterResponse
    */
+  @Public
+  @Stable
   public RegisterApplicationMasterResponse registerApplicationMaster(
       RegisterApplicationMasterRequest request) 
   throws YarnException, IOException;
@@ -86,6 +88,8 @@ public interface ApplicationMasterProtocol {
    * @see FinishApplicationMasterRequest
    * @see FinishApplicationMasterResponse
    */
+  @Public
+  @Stable
   public FinishApplicationMasterResponse finishApplicationMaster(
       FinishApplicationMasterRequest request) 
   throws YarnException, IOException;
@@ -122,6 +126,8 @@ public interface ApplicationMasterProtocol {
    * @see AllocateRequest
    * @see AllocateResponse
    */
+  @Public
+  @Stable
   public AllocateResponse allocate(AllocateRequest request) 
   throws YarnException, IOException;
 }

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/ApplicationMasterProtocolPB.java

@@ -17,9 +17,13 @@
  */
 package org.apache.hadoop.yarn.api;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.ipc.ProtocolInfo;
 import org.apache.hadoop.yarn.proto.ApplicationMasterProtocol.ApplicationMasterProtocolService;
 
+@Private
+@Unstable
 @ProtocolInfo(protocolName = "org.apache.hadoop.yarn.api.ApplicationMasterProtocolPB",
     protocolVersion = 1)
 public interface ApplicationMasterProtocolPB extends ApplicationMasterProtocolService.BlockingInterface {

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/ContainerManagementProtocolPB.java

@@ -17,9 +17,13 @@
  */
 package org.apache.hadoop.yarn.api;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.ipc.ProtocolInfo;
 import org.apache.hadoop.yarn.proto.ContainerManagementProtocol.ContainerManagementProtocolService;
 
+@Private
+@Unstable
 @ProtocolInfo(
     protocolName = "org.apache.hadoop.yarn.api.ContainerManagementProtocolPB",
     protocolVersion = 1)

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/ResourceManagerAdministrationProtocol.java

@@ -20,6 +20,8 @@ package org.apache.hadoop.yarn.api;
 
 import java.io.IOException;
 
+import org.apache.hadoop.classification.InterfaceAudience.Public;
+import org.apache.hadoop.classification.InterfaceStability.Stable;
 import org.apache.hadoop.tools.GetUserMappingsProtocol;
 import org.apache.hadoop.yarn.exceptions.YarnException;
 import org.apache.hadoop.yarn.api.protocolrecords.RefreshAdminAclsRequest;
@@ -35,26 +37,41 @@ import org.apache.hadoop.yarn.api.protocolrecords.RefreshSuperUserGroupsConfigur
 import org.apache.hadoop.yarn.api.protocolrecords.RefreshUserToGroupsMappingsRequest;
 import org.apache.hadoop.yarn.api.protocolrecords.RefreshUserToGroupsMappingsResponse;
 
+@Public
+@Stable
 public interface ResourceManagerAdministrationProtocol extends GetUserMappingsProtocol {
+
+  @Public
+  @Stable
   public RefreshQueuesResponse refreshQueues(RefreshQueuesRequest request) 
   throws YarnException, IOException;
-  
+
+  @Public
+  @Stable
   public RefreshNodesResponse refreshNodes(RefreshNodesRequest request)
   throws YarnException, IOException;
-  
+
+  @Public
+  @Stable
   public RefreshSuperUserGroupsConfigurationResponse 
   refreshSuperUserGroupsConfiguration(
       RefreshSuperUserGroupsConfigurationRequest request)
   throws YarnException, IOException;
 
+  @Public
+  @Stable
   public RefreshUserToGroupsMappingsResponse refreshUserToGroupsMappings(
       RefreshUserToGroupsMappingsRequest request)
   throws YarnException, IOException;
-  
+
+  @Public
+  @Stable
   public RefreshAdminAclsResponse refreshAdminAcls(
       RefreshAdminAclsRequest request)
   throws YarnException, IOException;
-  
+
+  @Public
+  @Stable
   public RefreshServiceAclsResponse refreshServiceAcls(
       RefreshServiceAclsRequest request)
   throws YarnException, IOException;

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/ResourceManagerAdministrationProtocolPB.java

@@ -17,9 +17,13 @@
  */
 package org.apache.hadoop.yarn.api;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.ipc.ProtocolInfo;
 import org.apache.hadoop.yarn.proto.ResourceManagerAdministrationProtocol.ResourceManagerAdministrationProtocolService;
 
+@Private
+@Unstable
 @ProtocolInfo(
     protocolName = "org.apache.hadoop.yarn.api.ResourceManagerAdministrationProtocolPB",
     protocolVersion = 1)

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/package-info.java

@@ -0,0 +1,21 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+@InterfaceAudience.Public
+package org.apache.hadoop.yarn.api;
+import org.apache.hadoop.classification.InterfaceAudience;
+

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/AllocateRequest.java

@@ -59,6 +59,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Stable
 public abstract class AllocateRequest {
 
+  @Public
+  @Stable
   public static AllocateRequest newInstance(
       ApplicationAttemptId applicationAttemptId, int responseID,
       float appProgress, List<ResourceRequest> resourceAsk,

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/AllocateResponse.java

@@ -43,10 +43,10 @@ import org.apache.hadoop.yarn.util.Records;
  *   <ul>
  *     <li>Response ID to track duplicate responses.</li>
  *     <li>
- *       A reboot flag to let the <code>ApplicationMaster</code> know that its 
- *       horribly out of sync and needs to reboot.</li>
+ *       An AMCommand sent by ResourceManager to let the <code>ApplicationMaster</code>
+ *       take some actions (resync, shutdown etc.).
  *     <li>A list of newly allocated {@link Container}.</li>
- *     <li>A list of completed {@link Container}.</li>
+ *     <li>A list of completed {@link Container}s' statuses.</li>
  *     <li>
  *       The available headroom for resources in the cluster for the
  *       application. 
@@ -63,6 +63,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Stable
 public abstract class AllocateResponse {
 
+  @Public
+  @Stable
   public static AllocateResponse newInstance(int responseId,
       List<ContainerStatus> completedContainers,
       List<Container> allocatedContainers, List<NodeReport> updatedNodes,
@@ -124,8 +126,8 @@ public abstract class AllocateResponse {
    * <code>ResourceManager</code>.
    * @param containers list of <em>newly allocated</em> <code>Container</code>
    */
-  @Public
-  @Stable
+  @Private
+  @Unstable
   public abstract void setAllocatedContainers(List<Container> containers);
 
   /**
@@ -160,7 +162,7 @@ public abstract class AllocateResponse {
    * @return The delta of updated nodes since the last response
    */
   @Public
-  @Unstable
+  @Stable
   public abstract  List<NodeReport> getUpdatedNodes();
 
   @Private
@@ -180,16 +182,16 @@ public abstract class AllocateResponse {
   public abstract void setNumClusterNodes(int numNodes);
 
   /**
-   * Get the description of containers owned by the AM, but requested back by
+   * <p>Get the description of containers owned by the AM, but requested back by
    * the cluster. Note that the RM may have an inconsistent view of the
    * resources owned by the AM. These messages are advisory, and the AM may
-   * elect to ignore them.
+   * elect to ignore them.<p>
    *
-   * The message is a snapshot of the resources the RM wants back from the AM.
+   * <p>The message is a snapshot of the resources the RM wants back from the AM.
    * While demand persists, the RM will repeat its request; applications should
-   * not interpret each message as a request for <emph>additional<emph>
+   * not interpret each message as a request for <em>additional<em>
    * resources on top of previous messages. Resources requested consistently
-   * over some duration may be forcibly killed by the RM.
+   * over some duration may be forcibly killed by the RM.<p>
    *
    * @return A specification of the resources to reclaim from this AM.
    */
@@ -200,24 +202,23 @@ public abstract class AllocateResponse {
   @Private
   @Unstable
   public abstract void setPreemptionMessage(PreemptionMessage request);
-  
-  @Public
-  @Stable
-  public abstract void setNMTokens(List<NMToken> nmTokens);
-  
+
   /**
-   * Get the list of NMTokens required for communicating with NM. New NMTokens
-   * issued only if
-   * 1) AM is receiving first container on underlying NodeManager.
-   * OR
+   * <p>Get the list of NMTokens required for communicating with NM. New NMTokens
+   * issued only if<p>
+   * <p>1) AM is receiving first container on underlying NodeManager.<br>
+   * OR<br>
    * 2) NMToken master key rolled over in ResourceManager and AM is getting new
-   * container on the same underlying NodeManager.
-   * AM will receive one NMToken per NM irrespective of the number of containers
+   * container on the same underlying NodeManager.<p>
+   * <p>AM will receive one NMToken per NM irrespective of the number of containers
    * issued on same NM. AM is expected to store these tokens until issued a
-   * new token for the same NM.
+   * new token for the same NM.<p>
    */
   @Public
   @Stable
   public abstract List<NMToken> getNMTokens();
 
+  @Private
+  @Unstable
+  public abstract void setNMTokens(List<NMToken> nmTokens);
 }

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/CancelDelegationTokenRequest.java

@@ -18,8 +18,8 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
-import org.apache.hadoop.classification.InterfaceAudience.Public;
-import org.apache.hadoop.classification.InterfaceStability.Evolving;
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.records.Token;
 import org.apache.hadoop.yarn.util.Records;
 
@@ -27,10 +27,12 @@ import org.apache.hadoop.yarn.util.Records;
  * The request issued by the client to the {@code ResourceManager} to cancel a
  * delegation token.
  */
-@Public
-@Evolving
+@Private
+@Unstable
 public abstract class CancelDelegationTokenRequest {
 
+  @Private
+  @Unstable
   public static CancelDelegationTokenRequest newInstance(Token dToken) {
     CancelDelegationTokenRequest request =
         Records.newRecord(CancelDelegationTokenRequest.class);
@@ -38,6 +40,15 @@ public abstract class CancelDelegationTokenRequest {
     return request;
   }
 
+  /**
+   * Get the delegation token requested to be cancelled.
+   * @return the delegation token requested to be cancelled.
+   */
+  @Private
+  @Unstable
   public abstract Token getDelegationToken();
+
+  @Private
+  @Unstable
   public abstract void setDelegationToken(Token dToken);
 }

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/CancelDelegationTokenResponse.java

@@ -18,17 +18,19 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
-import org.apache.hadoop.classification.InterfaceAudience.Public;
-import org.apache.hadoop.classification.InterfaceStability.Evolving;
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.util.Records;
 
 /**
  * The response from the {@code ResourceManager} to a cancelDelegationToken
  * request.
  */
-@Public
-@Evolving
+@Private
+@Unstable
 public abstract class CancelDelegationTokenResponse {
+  @Private
+  @Unstable
   public static CancelDelegationTokenResponse newInstance() {
     CancelDelegationTokenResponse response =
         Records.newRecord(CancelDelegationTokenResponse.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/FinishApplicationMasterRequest.java

@@ -46,8 +46,12 @@ import org.apache.hadoop.yarn.util.Records;
  *
  * @see ApplicationMasterProtocol#finishApplicationMaster(FinishApplicationMasterRequest)
  */
+@Public
+@Stable
 public abstract class FinishApplicationMasterRequest {
 
+  @Public
+  @Stable
   public static FinishApplicationMasterRequest newInstance(
       ApplicationAttemptId appAttemptId, FinalApplicationStatus finalAppStatus,
       String diagnostics, String url) {

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/FinishApplicationMasterResponse.java

@@ -18,8 +18,10 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
 import org.apache.hadoop.classification.InterfaceAudience.Public;
 import org.apache.hadoop.classification.InterfaceStability.Stable;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.ApplicationMasterProtocol;
 import org.apache.hadoop.yarn.util.Records;
 
@@ -34,6 +36,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Public
 @Stable
 public abstract class FinishApplicationMasterResponse {
+  @Private
+  @Unstable
   public static FinishApplicationMasterResponse newInstance() {
     FinishApplicationMasterResponse response =
         Records.newRecord(FinishApplicationMasterResponse.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/GetAllApplicationsRequest.java

@@ -34,6 +34,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Public
 @Stable
 public abstract class GetAllApplicationsRequest {
+  @Public
+  @Stable
   public static GetAllApplicationsRequest newInstance() {
     GetAllApplicationsRequest request =
         Records.newRecord(GetAllApplicationsRequest.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/GetAllApplicationsResponse.java

@@ -42,7 +42,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Public
 @Stable
 public abstract class GetAllApplicationsResponse {
-
+  @Private
+  @Unstable
   public static GetAllApplicationsResponse newInstance(
       List<ApplicationReport> applications) {
     GetAllApplicationsResponse response =

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/GetApplicationReportRequest.java

@@ -39,6 +39,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Stable
 public abstract class GetApplicationReportRequest {
 
+  @Public
+  @Stable
   public static GetApplicationReportRequest newInstance(
       ApplicationId applicationId) {
     GetApplicationReportRequest request =
@@ -51,11 +53,15 @@ public abstract class GetApplicationReportRequest {
    * Get the <code>ApplicationId</code> of the application.
    * @return <code>ApplicationId</code> of the application
    */
+  @Public
+  @Stable
   public abstract ApplicationId getApplicationId();
   
   /**
    * Set the <code>ApplicationId</code> of the application
    * @param applicationId <code>ApplicationId</code> of the application
    */
+  @Public
+  @Stable
   public abstract void setApplicationId(ApplicationId applicationId);
 }

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/GetApplicationReportResponse.java

@@ -40,6 +40,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Stable
 public abstract class GetApplicationReportResponse {
 
+  @Private
+  @Unstable
   public static GetApplicationReportResponse newInstance(
       ApplicationReport ApplicationReport) {
     GetApplicationReportResponse response =

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/GetClusterMetricsRequest.java

@@ -34,6 +34,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Public
 @Stable
 public abstract class GetClusterMetricsRequest {
+  @Public
+  @Stable
   public static GetClusterMetricsRequest newInstance() {
     GetClusterMetricsRequest request =
         Records.newRecord(GetClusterMetricsRequest.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/GetClusterMetricsResponse.java

@@ -37,6 +37,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Stable
 public abstract class GetClusterMetricsResponse {
 
+  @Private
+  @Unstable
   public static GetClusterMetricsResponse
       newInstance(YarnClusterMetrics metrics) {
     GetClusterMetricsResponse response =

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/GetClusterNodesRequest.java

@@ -34,6 +34,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Public
 @Stable
 public abstract class GetClusterNodesRequest {
+  @Public
+  @Stable 
   public static GetClusterNodesRequest newInstance() {
     GetClusterNodesRequest request =
         Records.newRecord(GetClusterNodesRequest.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/GetClusterNodesResponse.java

@@ -43,6 +43,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Stable
 public abstract class GetClusterNodesResponse {
 
+  @Private
+  @Unstable
   public static GetClusterNodesResponse
       newInstance(List<NodeReport> nodeReports) {
     GetClusterNodesResponse response =

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/GetContainerStatusRequest.java

@@ -35,6 +35,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Stable
 public abstract class GetContainerStatusRequest {
 
+  @Public
+  @Stable
   public static GetContainerStatusRequest newInstance(ContainerId containerId) {
     GetContainerStatusRequest request =
         Records.newRecord(GetContainerStatusRequest.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/GetContainerStatusResponse.java

@@ -37,6 +37,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Stable
 public abstract class GetContainerStatusResponse {
 
+  @Private
+  @Unstable
   public static GetContainerStatusResponse newInstance(
       ContainerStatus containerStatus) {
     GetContainerStatusResponse response =

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/GetDelegationTokenRequest.java

@@ -19,7 +19,7 @@
 package org.apache.hadoop.yarn.api.protocolrecords;
 
 import org.apache.hadoop.classification.InterfaceAudience.Public;
-import org.apache.hadoop.classification.InterfaceStability.Evolving;
+import org.apache.hadoop.classification.InterfaceStability.Stable;
 import org.apache.hadoop.yarn.util.Records;
 
 /**
@@ -28,9 +28,11 @@ import org.apache.hadoop.yarn.util.Records;
  * for more information.
  */
 @Public
-@Evolving
+@Stable
 public abstract class GetDelegationTokenRequest {
 
+  @Public
+  @Stable
   public GetDelegationTokenRequest newInstance(String renewer) {
     GetDelegationTokenRequest request =
         Records.newRecord(GetDelegationTokenRequest.class);
@@ -38,6 +40,11 @@ public abstract class GetDelegationTokenRequest {
     return request;
   }
 
+  @Public
+  @Stable
   public abstract String getRenewer();
+
+  @Public
+  @Stable
   public abstract void setRenewer(String renewer);
 }

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/GetDelegationTokenResponse.java

@@ -18,8 +18,10 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
 import org.apache.hadoop.classification.InterfaceAudience.Public;
-import org.apache.hadoop.classification.InterfaceStability.Evolving;
+import org.apache.hadoop.classification.InterfaceStability.Stable;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.security.token.delegation.AbstractDelegationTokenIdentifier;
 import org.apache.hadoop.yarn.api.records.Token;
 import org.apache.hadoop.yarn.util.Records;
@@ -32,9 +34,11 @@ import org.apache.hadoop.yarn.util.Records;
  *
  */
 @Public
-@Evolving
+@Stable
 public abstract class GetDelegationTokenResponse {
 
+  @Private
+  @Unstable
   public static GetDelegationTokenResponse newInstance(Token rmDTToken) {
     GetDelegationTokenResponse response =
         Records.newRecord(GetDelegationTokenResponse.class);
@@ -47,6 +51,11 @@ public abstract class GetDelegationTokenResponse {
    * {@link AbstractDelegationTokenIdentifier}.
    *
    */
+  @Public
+  @Stable
   public abstract Token getRMDelegationToken();
+
+  @Private
+  @Unstable
   public abstract void setRMDelegationToken(Token rmDTToken);
 }

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/GetNewApplicationRequest.java

@@ -35,6 +35,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Public
 @Stable
 public abstract class GetNewApplicationRequest {
+  @Public
+  @Stable
   public static GetNewApplicationRequest newInstance() {
     GetNewApplicationRequest request =
         Records.newRecord(GetNewApplicationRequest.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/GetNewApplicationResponse.java

@@ -37,6 +37,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Stable
 public abstract class GetNewApplicationResponse {
 
+  @Private
+  @Unstable
   public static GetNewApplicationResponse newInstance(
       ApplicationId applicationId, Resource minCapability,
       Resource maxCapability) {

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/GetQueueInfoRequest.java

@@ -33,6 +33,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Stable
 public abstract class GetQueueInfoRequest {
 
+  @Public
+  @Stable
   public static GetQueueInfoRequest
       newInstance(String queueName, boolean includeApplications,
           boolean includeChildQueues, boolean recursive) {
@@ -48,12 +50,16 @@ public abstract class GetQueueInfoRequest {
    * Get the <em>queue name</em> for which to get queue information.
    * @return <em>queue name</em> for which to get queue information
    */
+  @Public
+  @Stable
   public abstract String getQueueName();
   
   /**
    * Set the <em>queue name</em> for which to get queue information
    * @param queueName <em>queue name</em> for which to get queue information
    */
+  @Public
+  @Stable
   public abstract void setQueueName(String queueName);
 
   /**
@@ -61,6 +67,8 @@ public abstract class GetQueueInfoRequest {
    * @return <code>true</code> if applications' information is to be included,
    *         else <code>false</code>
    */
+  @Public
+  @Stable
   public abstract boolean getIncludeApplications();
 
   /**
@@ -68,6 +76,8 @@ public abstract class GetQueueInfoRequest {
    * @param includeApplications fetch information about <em>active 
    *                            applications</em>?
    */
+  @Public
+  @Stable
   public abstract void setIncludeApplications(boolean includeApplications);
 
   /**
@@ -75,12 +85,16 @@ public abstract class GetQueueInfoRequest {
    * @return <code>true</code> if information about child queues is required,
    *         else <code>false</code>
    */
+  @Public
+  @Stable
   public abstract boolean getIncludeChildQueues();
   
   /**
    * Should we fetch information about <em>child queues</em>?
    * @param includeChildQueues fetch information about <em>child queues</em>?
    */
+  @Public
+  @Stable
   public abstract void setIncludeChildQueues(boolean includeChildQueues);
 
   /**
@@ -88,6 +102,8 @@ public abstract class GetQueueInfoRequest {
    * @return <code>true</code> if information about entire hierarchy is 
    *         required, <code>false</code> otherwise
    */
+  @Public
+  @Stable
   public abstract boolean getRecursive();
   
   /**
@@ -95,6 +111,8 @@ public abstract class GetQueueInfoRequest {
    * @param recursive fetch information on the entire <em>child queue 
    *                  hierarchy</em>?
    */
+  @Public
+  @Stable
   public abstract void setRecursive(boolean recursive);
 }
 

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/GetQueueInfoResponse.java

@@ -41,6 +41,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Stable
 public abstract class GetQueueInfoResponse {
 
+  @Private
+  @Unstable
   public static GetQueueInfoResponse newInstance(QueueInfo queueInfo) {
     GetQueueInfoResponse response = Records.newRecord(GetQueueInfoResponse.class);
     response.setQueueInfo(queueInfo);
@@ -51,6 +53,8 @@ public abstract class GetQueueInfoResponse {
    * Get the <code>QueueInfo</code> for the specified queue.
    * @return <code>QueueInfo</code> for the specified queue
    */
+  @Public
+  @Stable
   public abstract QueueInfo getQueueInfo();
   
   @Private

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/GetQueueUserAclsInfoRequest.java

@@ -34,6 +34,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Public
 @Stable
 public abstract class GetQueueUserAclsInfoRequest {
+  @Public
+  @Stable
   public static GetQueueUserAclsInfoRequest newInstance() {
     GetQueueUserAclsInfoRequest request =
         Records.newRecord(GetQueueUserAclsInfoRequest.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/GetQueueUserAclsInfoResponse.java

@@ -44,6 +44,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Stable
 public abstract class GetQueueUserAclsInfoResponse {
 
+  @Private
+  @Unstable
   public static GetQueueUserAclsInfoResponse newInstance(
       List<QueueUserACLInfo> queueUserAclsList) {
     GetQueueUserAclsInfoResponse response =

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/KillApplicationRequest.java

@@ -18,10 +18,8 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
-import org.apache.hadoop.classification.InterfaceAudience.Private;
 import org.apache.hadoop.classification.InterfaceAudience.Public;
 import org.apache.hadoop.classification.InterfaceStability.Stable;
-import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.ApplicationClientProtocol;
 import org.apache.hadoop.yarn.api.records.ApplicationId;
 import org.apache.hadoop.yarn.util.Records;
@@ -39,6 +37,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Stable
 public abstract class KillApplicationRequest {
 
+  @Public
+  @Stable 
   public static KillApplicationRequest newInstance(ApplicationId applicationId) {
     KillApplicationRequest request =
         Records.newRecord(KillApplicationRequest.class);
@@ -54,7 +54,7 @@ public abstract class KillApplicationRequest {
   @Stable
   public abstract ApplicationId getApplicationId();
   
-  @Private
-  @Unstable
+  @Public
+  @Stable
   public abstract void setApplicationId(ApplicationId applicationId);
 }

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/KillApplicationResponse.java

@@ -18,8 +18,10 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
 import org.apache.hadoop.classification.InterfaceAudience.Public;
 import org.apache.hadoop.classification.InterfaceStability.Stable;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.ApplicationClientProtocol;
 import org.apache.hadoop.yarn.util.Records;
 
@@ -34,6 +36,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Public
 @Stable
 public abstract class KillApplicationResponse {
+  @Private
+  @Unstable
   public static KillApplicationResponse newInstance() {
     KillApplicationResponse response =
         Records.newRecord(KillApplicationResponse.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/RefreshAdminAclsRequest.java

@@ -18,9 +18,15 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
+import org.apache.hadoop.classification.InterfaceAudience.Public;
+import org.apache.hadoop.classification.InterfaceStability.Stable;
 import org.apache.hadoop.yarn.util.Records;
 
+@Public
+@Stable
 public abstract class RefreshAdminAclsRequest {
+  @Public
+  @Stable
   public static RefreshAdminAclsRequest newInstance() {
     RefreshAdminAclsRequest request =
         Records.newRecord(RefreshAdminAclsRequest.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/RefreshAdminAclsResponse.java

@@ -18,9 +18,17 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceAudience.Public;
+import org.apache.hadoop.classification.InterfaceStability.Stable;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.util.Records;
 
+@Public
+@Stable
 public abstract class RefreshAdminAclsResponse {
+  @Private
+  @Unstable
   public static RefreshAdminAclsResponse newInstance() {
     RefreshAdminAclsResponse response =
         Records.newRecord(RefreshAdminAclsResponse.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/RefreshNodesRequest.java

@@ -18,9 +18,15 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
+import org.apache.hadoop.classification.InterfaceAudience.Public;
+import org.apache.hadoop.classification.InterfaceStability.Stable;
 import org.apache.hadoop.yarn.util.Records;
 
+@Public
+@Stable
 public abstract class RefreshNodesRequest {
+  @Public
+  @Stable
   public static RefreshNodesRequest newInstance() {
     RefreshNodesRequest request = Records.newRecord(RefreshNodesRequest.class);
     return request;

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/RefreshNodesResponse.java

@@ -18,9 +18,17 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceAudience.Public;
+import org.apache.hadoop.classification.InterfaceStability.Stable;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.util.Records;
 
+@Public
+@Stable
 public abstract class RefreshNodesResponse {
+  @Private
+  @Unstable
   public static RefreshNodesResponse newInstance() {
     RefreshNodesResponse response =
         Records.newRecord(RefreshNodesResponse.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/RefreshQueuesRequest.java

@@ -18,9 +18,15 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
+import org.apache.hadoop.classification.InterfaceAudience.Public;
+import org.apache.hadoop.classification.InterfaceStability.Stable;
 import org.apache.hadoop.yarn.util.Records;
 
+@Public
+@Stable
 public abstract class RefreshQueuesRequest {
+  @Public
+  @Stable
   public static RefreshQueuesRequest newInstance() {
     RefreshQueuesRequest request =
         Records.newRecord(RefreshQueuesRequest.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/RefreshQueuesResponse.java

@@ -18,9 +18,17 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceAudience.Public;
+import org.apache.hadoop.classification.InterfaceStability.Stable;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.util.Records;
 
+@Public
+@Stable
 public abstract class RefreshQueuesResponse {
+  @Private
+  @Unstable
   public static RefreshQueuesResponse newInstance() {
     RefreshQueuesResponse response =
         Records.newRecord(RefreshQueuesResponse.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/RefreshServiceAclsRequest.java

@@ -18,9 +18,15 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
+import org.apache.hadoop.classification.InterfaceAudience.Public;
+import org.apache.hadoop.classification.InterfaceStability.Stable;
 import org.apache.hadoop.yarn.util.Records;
 
+@Public
+@Stable
 public abstract class RefreshServiceAclsRequest {
+  @Public
+  @Stable
   public static RefreshServiceAclsRequest newInstance() {
     RefreshServiceAclsRequest request =
         Records.newRecord(RefreshServiceAclsRequest.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/RefreshServiceAclsResponse.java

@@ -18,9 +18,17 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceAudience.Public;
+import org.apache.hadoop.classification.InterfaceStability.Stable;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.util.Records;
 
+@Public
+@Stable
 public abstract class RefreshServiceAclsResponse {
+  @Private
+  @Unstable
   public static RefreshServiceAclsResponse newInstance() {
     RefreshServiceAclsResponse response =
         Records.newRecord(RefreshServiceAclsResponse.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/RefreshSuperUserGroupsConfigurationRequest.java

@@ -18,9 +18,15 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
+import org.apache.hadoop.classification.InterfaceAudience.Public;
+import org.apache.hadoop.classification.InterfaceStability.Stable;
 import org.apache.hadoop.yarn.util.Records;
 
+@Public
+@Stable
 public abstract class RefreshSuperUserGroupsConfigurationRequest {
+  @Public
+  @Stable
   public static RefreshSuperUserGroupsConfigurationRequest newInstance() {
     RefreshSuperUserGroupsConfigurationRequest request =
         Records.newRecord(RefreshSuperUserGroupsConfigurationRequest.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/RefreshSuperUserGroupsConfigurationResponse.java

@@ -18,9 +18,17 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceAudience.Public;
+import org.apache.hadoop.classification.InterfaceStability.Stable;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.util.Records;
 
+@Public
+@Stable
 public abstract class RefreshSuperUserGroupsConfigurationResponse {
+  @Private
+  @Unstable
   public static RefreshSuperUserGroupsConfigurationResponse newInstance() {
     RefreshSuperUserGroupsConfigurationResponse response =
         Records.newRecord(RefreshSuperUserGroupsConfigurationResponse.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/RefreshUserToGroupsMappingsRequest.java

@@ -18,9 +18,15 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
+import org.apache.hadoop.classification.InterfaceAudience.Public;
+import org.apache.hadoop.classification.InterfaceStability.Stable;
 import org.apache.hadoop.yarn.util.Records;
 
+@Public
+@Stable
 public abstract class RefreshUserToGroupsMappingsRequest {
+  @Public
+  @Stable
   public static RefreshUserToGroupsMappingsRequest newInstance() {
     RefreshUserToGroupsMappingsRequest request =
         Records.newRecord(RefreshUserToGroupsMappingsRequest.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/RefreshUserToGroupsMappingsResponse.java

@@ -18,9 +18,17 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceAudience.Public;
+import org.apache.hadoop.classification.InterfaceStability.Stable;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.util.Records;
 
+@Public
+@Stable
 public abstract class RefreshUserToGroupsMappingsResponse {
+  @Private
+  @Unstable
   public static RefreshUserToGroupsMappingsResponse newInstance() {
     RefreshUserToGroupsMappingsResponse response =
         Records.newRecord(RefreshUserToGroupsMappingsResponse.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/RegisterApplicationMasterRequest.java

@@ -18,10 +18,8 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
-import org.apache.hadoop.classification.InterfaceAudience.Private;
 import org.apache.hadoop.classification.InterfaceAudience.Public;
 import org.apache.hadoop.classification.InterfaceStability.Stable;
-import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.ApplicationMasterProtocol;
 import org.apache.hadoop.yarn.api.records.ApplicationAttemptId;
 import org.apache.hadoop.yarn.util.Records;
@@ -48,6 +46,17 @@ import org.apache.hadoop.yarn.util.Records;
 @Stable
 public abstract class RegisterApplicationMasterRequest {
 
+  /**
+   * Create a new instance of <code>RegisterApplicationMasterRequest</code>.
+   * If <em>port, trackingUrl</em> is not used, use the following default value:
+   * <ul>
+   *  <li>port: -1</li>
+   *  <li>trackingUrl: null</li>
+   * </ul>
+   * @return the new instance of <code>RegisterApplicationMasterRequest</code>
+   */
+  @Public
+  @Stable
   public static RegisterApplicationMasterRequest newInstance(
       ApplicationAttemptId applicationAttemptId, String host, int port,
       String trackingUrl) {
@@ -95,8 +104,8 @@ public abstract class RegisterApplicationMasterRequest {
    * @param host <em>host</em> on which the <code>ApplicationMaster</code> 
    *             is running
    */
-  @Private
-  @Unstable
+  @Public
+  @Stable
   public abstract void setHost(String host);
 
   /**

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/RegisterApplicationMasterResponse.java

@@ -46,7 +46,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Public
 @Stable
 public abstract class RegisterApplicationMasterResponse {
-
+  @Private
+  @Unstable
   public static RegisterApplicationMasterResponse newInstance(
       Resource minCapability, Resource maxCapability,
       Map<ApplicationAccessType, String> acls) {
@@ -56,7 +57,7 @@ public abstract class RegisterApplicationMasterResponse {
     response.setApplicationACLs(acls);
     return response;
   }
-  
+
   /**
    * Get the maximum capability for any {@link Resource} allocated by the 
    * <code>ResourceManager</code> in the cluster.
@@ -85,18 +86,21 @@ public abstract class RegisterApplicationMasterResponse {
   @Private
   @Unstable
   public abstract void setApplicationACLs(Map<ApplicationAccessType, String> acls);
-  
+
   /**
-   * Set ClientToAMToken master key.
+   * <p>Get ClientToAMToken master key.</p>
+   * <p>The ClientToAMToken master key is sent to <code>ApplicationMaster</code>
+   * by <code>ResourceManager</code> via {@link RegisterApplicationMasterResponse}
+   * , used to verify corresponding ClientToAMToken.</p>
    */
   @Public
   @Stable
-  public abstract void setClientToAMTokenMasterKey(ByteBuffer key);
-  
+  public abstract ByteBuffer getClientToAMTokenMasterKey();
+
   /**
-   * Get ClientToAMToken master key.
+   * Set ClientToAMToken master key.
    */
   @Public
   @Stable
-  public abstract ByteBuffer getClientToAMTokenMasterKey();
+  public abstract void setClientToAMTokenMasterKey(ByteBuffer key);
 }

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/RenewDelegationTokenRequest.java

@@ -18,8 +18,8 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
-import org.apache.hadoop.classification.InterfaceAudience.Public;
-import org.apache.hadoop.classification.InterfaceStability.Evolving;
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.records.Token;
 import org.apache.hadoop.yarn.util.Records;
 
@@ -27,10 +27,11 @@ import org.apache.hadoop.yarn.util.Records;
  * The request issued by the client to renew a delegation token from
  * the {@code ResourceManager}.
  */
-@Public
-@Evolving
+@Private
+@Unstable
 public abstract class RenewDelegationTokenRequest {
-
+  @Private
+  @Unstable
   public static RenewDelegationTokenRequest newInstance(Token dToken) {
     RenewDelegationTokenRequest request =
         Records.newRecord(RenewDelegationTokenRequest.class);
@@ -38,7 +39,15 @@ public abstract class RenewDelegationTokenRequest {
     return request;
   }
 
+  /**
+   * Get the delegation token requested to be renewed by the client.
+   * @return the delegation token requested to be renewed by the client.
+   */
+  @Private
+  @Unstable
   public abstract Token getDelegationToken();
 
+  @Private
+  @Unstable
   public abstract void setDelegationToken(Token dToken);
 }

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/RenewDelegationTokenResponse.java

@@ -18,17 +18,19 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
-import org.apache.hadoop.classification.InterfaceAudience.Public;
-import org.apache.hadoop.classification.InterfaceStability.Evolving;
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.util.Records;
 
 /**
  * The response to a renewDelegationToken call to the {@code ResourceManager}.
  */
-@Public
-@Evolving
+@Private
+@Unstable
 public abstract class RenewDelegationTokenResponse {
 
+  @Private
+  @Unstable
   public static RenewDelegationTokenResponse newInstance(long expTime) {
     RenewDelegationTokenResponse response =
         Records.newRecord(RenewDelegationTokenResponse.class);
@@ -36,7 +38,11 @@ public abstract class RenewDelegationTokenResponse {
     return response;
   }
 
+  @Private
+  @Unstable
   public abstract long getNextExpirationTime();
 
+  @Private
+  @Unstable
   public abstract void setNextExpirationTime(long expTime);
 }

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/StartContainerRequest.java

@@ -22,6 +22,7 @@ import org.apache.hadoop.classification.InterfaceAudience.Public;
 import org.apache.hadoop.classification.InterfaceStability.Stable;
 import org.apache.hadoop.yarn.api.ContainerManagementProtocol;
 import org.apache.hadoop.yarn.api.records.ContainerLaunchContext;
+import org.apache.hadoop.yarn.api.records.NMToken;
 import org.apache.hadoop.yarn.api.records.Token;
 import org.apache.hadoop.yarn.util.Records;
 
@@ -40,7 +41,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Public
 @Stable
 public abstract class StartContainerRequest {
-
+  @Public
+  @Stable
   public static StartContainerRequest newInstance(
       ContainerLaunchContext context, Token container) {
     StartContainerRequest request =
@@ -71,6 +73,16 @@ public abstract class StartContainerRequest {
   @Stable
   public abstract void setContainerLaunchContext(ContainerLaunchContext context);
 
+  /**
+   * <p>Get the container token to be used for authorization during starting
+   * container.</p>
+   * <p>Note: {@link NMToken} will be used for authenticating communication with </code>
+   * NodeManager</code>.</p>
+   * @return the container token to be used for authorization during starting
+   * container.
+   * @see NMToken
+   * @see ContainerManagementProtocol#startContainer(StartContainerRequest)
+   */
   @Public
   @Stable
   public abstract Token getContainerToken();

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/StartContainerResponse.java

@@ -21,8 +21,10 @@ package org.apache.hadoop.yarn.api.protocolrecords;
 import java.nio.ByteBuffer;
 import java.util.Map;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
 import org.apache.hadoop.classification.InterfaceAudience.Public;
 import org.apache.hadoop.classification.InterfaceStability.Stable;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.ContainerManagementProtocol;
 import org.apache.hadoop.yarn.util.Records;
 
@@ -37,6 +39,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Stable
 public abstract class StartContainerResponse {
 
+  @Private
+  @Unstable
   public static StartContainerResponse newInstance(
       Map<String, ByteBuffer> serviceResponses) {
     StartContainerResponse response =
@@ -52,6 +56,8 @@ public abstract class StartContainerResponse {
    * and their corresponding opaque blob <code>ByteBuffer</code>s</p> 
    * @return a Map between the auxiliary service names and their outputs
    */
+  @Public
+  @Stable
   public abstract Map<String, ByteBuffer> getAllServiceResponse();
 
   /**
@@ -61,5 +67,7 @@ public abstract class StartContainerResponse {
    * @param serviceResponses A map from auxiliary service names to the opaque
    * blob <code>ByteBuffer</code>s for that auxiliary service
    */
+  @Private
+  @Unstable
   public abstract void setAllServiceResponse(Map<String, ByteBuffer> serviceResponses);
 }

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/StopContainerRequest.java

@@ -34,6 +34,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Stable
 public abstract class StopContainerRequest {
 
+  @Public
+  @Stable
   public static StopContainerRequest newInstance(ContainerId containerId) {
     StopContainerRequest request =
         Records.newRecord(StopContainerRequest.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/StopContainerResponse.java

@@ -18,8 +18,10 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
 import org.apache.hadoop.classification.InterfaceAudience.Public;
 import org.apache.hadoop.classification.InterfaceStability.Stable;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.ContainerManagementProtocol;
 import org.apache.hadoop.yarn.util.Records;
 
@@ -35,6 +37,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Public
 @Stable
 public abstract class StopContainerResponse {
+  @Private
+  @Unstable
   public static StopContainerResponse newInstance() {
     StopContainerResponse response =
         Records.newRecord(StopContainerResponse.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/SubmitApplicationRequest.java

@@ -42,6 +42,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Stable
 public abstract class SubmitApplicationRequest {
 
+  @Public
+  @Stable
   public static SubmitApplicationRequest newInstance(
       ApplicationSubmissionContext context) {
     SubmitApplicationRequest request =

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/SubmitApplicationResponse.java

@@ -18,8 +18,10 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
 import org.apache.hadoop.classification.InterfaceAudience.Public;
 import org.apache.hadoop.classification.InterfaceStability.Stable;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.ApplicationClientProtocol;
 import org.apache.hadoop.yarn.util.Records;
 
@@ -34,6 +36,8 @@ import org.apache.hadoop.yarn.util.Records;
 @Public
 @Stable
 public abstract class SubmitApplicationResponse {
+  @Private
+  @Unstable
   public static SubmitApplicationResponse newInstance() {
     SubmitApplicationResponse response =
         Records.newRecord(SubmitApplicationResponse.class);

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/AllocateRequestPBImpl.java

@@ -23,24 +23,26 @@ import java.util.ArrayList;
 import java.util.Iterator;
 import java.util.List;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.AllocateRequest;
 import org.apache.hadoop.yarn.api.records.ApplicationAttemptId;
-import org.apache.hadoop.yarn.api.records.ResourceBlacklistRequest;
 import org.apache.hadoop.yarn.api.records.ContainerId;
+import org.apache.hadoop.yarn.api.records.ResourceBlacklistRequest;
 import org.apache.hadoop.yarn.api.records.ResourceRequest;
 import org.apache.hadoop.yarn.api.records.impl.pb.ApplicationAttemptIdPBImpl;
-import org.apache.hadoop.yarn.api.records.impl.pb.ResourceBlacklistRequestPBImpl;
 import org.apache.hadoop.yarn.api.records.impl.pb.ContainerIdPBImpl;
+import org.apache.hadoop.yarn.api.records.impl.pb.ResourceBlacklistRequestPBImpl;
 import org.apache.hadoop.yarn.api.records.impl.pb.ResourceRequestPBImpl;
 import org.apache.hadoop.yarn.proto.YarnProtos.ApplicationAttemptIdProto;
-import org.apache.hadoop.yarn.proto.YarnProtos.ResourceBlacklistRequestProto;
 import org.apache.hadoop.yarn.proto.YarnProtos.ContainerIdProto;
+import org.apache.hadoop.yarn.proto.YarnProtos.ResourceBlacklistRequestProto;
 import org.apache.hadoop.yarn.proto.YarnProtos.ResourceRequestProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.AllocateRequestProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.AllocateRequestProtoOrBuilder;
 
-
-    
+@Private
+@Unstable
 public class AllocateRequestPBImpl extends AllocateRequest {
   AllocateRequestProto proto = AllocateRequestProto.getDefaultInstance();
   AllocateRequestProto.Builder builder = null;

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/AllocateResponsePBImpl.java

@@ -23,6 +23,8 @@ import java.util.ArrayList;
 import java.util.Iterator;
 import java.util.List;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.AllocateResponse;
 import org.apache.hadoop.yarn.api.records.AMCommand;
 import org.apache.hadoop.yarn.api.records.Container;
@@ -44,10 +46,11 @@ import org.apache.hadoop.yarn.proto.YarnProtos.PreemptionMessageProto;
 import org.apache.hadoop.yarn.proto.YarnProtos.ResourceProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.AllocateResponseProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.AllocateResponseProtoOrBuilder;
-import org.apache.hadoop.yarn.util.ProtoUtils;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.NMTokenProto;
+import org.apache.hadoop.yarn.util.ProtoUtils;
 
-    
+@Private
+@Unstable
 public class AllocateResponsePBImpl extends AllocateResponse {
   AllocateResponseProto proto = AllocateResponseProto.getDefaultInstance();
   AllocateResponseProto.Builder builder = null;

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/CancelDelegationTokenRequestPBImpl.java

@@ -17,6 +17,8 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.security.proto.SecurityProtos.CancelDelegationTokenRequestProto;
 import org.apache.hadoop.security.proto.SecurityProtos.CancelDelegationTokenRequestProtoOrBuilder;
 import org.apache.hadoop.security.proto.SecurityProtos.TokenProto;
@@ -24,6 +26,8 @@ import org.apache.hadoop.yarn.api.protocolrecords.CancelDelegationTokenRequest;
 import org.apache.hadoop.yarn.api.records.Token;
 import org.apache.hadoop.yarn.api.records.impl.pb.TokenPBImpl;
 
+@Private
+@Unstable
 public class CancelDelegationTokenRequestPBImpl extends
     CancelDelegationTokenRequest {
 

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/CancelDelegationTokenResponsePBImpl.java

@@ -17,9 +17,13 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.security.proto.SecurityProtos.CancelDelegationTokenResponseProto;
 import org.apache.hadoop.yarn.api.protocolrecords.CancelDelegationTokenResponse;
 
+@Private
+@Unstable
 public class CancelDelegationTokenResponsePBImpl extends CancelDelegationTokenResponse {
   
   CancelDelegationTokenResponseProto proto = CancelDelegationTokenResponseProto

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/FinishApplicationMasterRequestPBImpl.java

@@ -19,6 +19,8 @@
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.FinishApplicationMasterRequest;
 import org.apache.hadoop.yarn.api.records.ApplicationAttemptId;
 import org.apache.hadoop.yarn.api.records.FinalApplicationStatus;
@@ -29,7 +31,8 @@ import org.apache.hadoop.yarn.proto.YarnServiceProtos.FinishApplicationMasterReq
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.FinishApplicationMasterRequestProtoOrBuilder;
 import org.apache.hadoop.yarn.util.ProtoUtils;
 
-
+@Private
+@Unstable
 public class FinishApplicationMasterRequestPBImpl extends FinishApplicationMasterRequest {
   FinishApplicationMasterRequestProto proto = FinishApplicationMasterRequestProto.getDefaultInstance();
   FinishApplicationMasterRequestProto.Builder builder = null;

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/FinishApplicationMasterResponsePBImpl.java

@@ -19,11 +19,13 @@
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.FinishApplicationMasterResponse;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.FinishApplicationMasterResponseProto;
 
-
-    
+@Private
+@Unstable
 public class FinishApplicationMasterResponsePBImpl extends FinishApplicationMasterResponse {
   FinishApplicationMasterResponseProto proto = FinishApplicationMasterResponseProto.getDefaultInstance();
   FinishApplicationMasterResponseProto.Builder builder = null;
@@ -63,16 +65,4 @@ public class FinishApplicationMasterResponsePBImpl extends FinishApplicationMast
   public String toString() {
     return getProto().toString().replaceAll("\\n", ", ").replaceAll("\\s+", " ");
   }
-
-  private void maybeInitBuilder() {
-    if (viaProto || builder == null) {
-      builder = FinishApplicationMasterResponseProto.newBuilder(proto);
-    }
-    viaProto = false;
-  }
-    
-  
-
-
-
 }  

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/GetAllApplicationsRequestPBImpl.java

@@ -18,9 +18,13 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.GetAllApplicationsRequest;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetAllApplicationsRequestProto;
 
+@Private
+@Unstable
 public class GetAllApplicationsRequestPBImpl extends GetAllApplicationsRequest {
   GetAllApplicationsRequestProto proto = GetAllApplicationsRequestProto.getDefaultInstance();
   GetAllApplicationsRequestProto.Builder builder = null;

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/GetAllApplicationsResponsePBImpl.java

@@ -22,6 +22,8 @@ import java.util.ArrayList;
 import java.util.Iterator;
 import java.util.List;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.GetAllApplicationsResponse;
 import org.apache.hadoop.yarn.api.records.ApplicationReport;
 import org.apache.hadoop.yarn.api.records.impl.pb.ApplicationReportPBImpl;
@@ -29,6 +31,8 @@ import org.apache.hadoop.yarn.proto.YarnProtos.ApplicationReportProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetAllApplicationsResponseProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetAllApplicationsResponseProtoOrBuilder;
 
+@Private
+@Unstable
 public class GetAllApplicationsResponsePBImpl 
 extends GetAllApplicationsResponse {
 

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/GetApplicationReportRequestPBImpl.java

@@ -19,6 +19,8 @@
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.GetApplicationReportRequest;
 import org.apache.hadoop.yarn.api.records.ApplicationId;
 import org.apache.hadoop.yarn.api.records.impl.pb.ApplicationIdPBImpl;
@@ -26,8 +28,8 @@ import org.apache.hadoop.yarn.proto.YarnProtos.ApplicationIdProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetApplicationReportRequestProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetApplicationReportRequestProtoOrBuilder;
 
-
-    
+@Private
+@Unstable
 public class GetApplicationReportRequestPBImpl extends GetApplicationReportRequest {
   GetApplicationReportRequestProto proto = GetApplicationReportRequestProto.getDefaultInstance();
   GetApplicationReportRequestProto.Builder builder = null;

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/GetApplicationReportResponsePBImpl.java

@@ -19,6 +19,8 @@
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.GetApplicationReportResponse;
 import org.apache.hadoop.yarn.api.records.ApplicationReport;
 import org.apache.hadoop.yarn.api.records.impl.pb.ApplicationReportPBImpl;
@@ -26,8 +28,8 @@ import org.apache.hadoop.yarn.proto.YarnProtos.ApplicationReportProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetApplicationReportResponseProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetApplicationReportResponseProtoOrBuilder;
 
-
-    
+@Private
+@Unstable
 public class GetApplicationReportResponsePBImpl extends GetApplicationReportResponse {
   GetApplicationReportResponseProto proto = GetApplicationReportResponseProto.getDefaultInstance();
   GetApplicationReportResponseProto.Builder builder = null;

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/GetClusterMetricsRequestPBImpl.java

@@ -19,11 +19,13 @@
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.GetClusterMetricsRequest;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetClusterMetricsRequestProto;
 
-
-    
+@Private
+@Unstable
 public class GetClusterMetricsRequestPBImpl extends GetClusterMetricsRequest {
   GetClusterMetricsRequestProto proto = GetClusterMetricsRequestProto.getDefaultInstance();
   GetClusterMetricsRequestProto.Builder builder = null;

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/GetClusterMetricsResponsePBImpl.java

@@ -19,6 +19,8 @@
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.GetClusterMetricsResponse;
 import org.apache.hadoop.yarn.api.records.YarnClusterMetrics;
 import org.apache.hadoop.yarn.api.records.impl.pb.YarnClusterMetricsPBImpl;
@@ -26,8 +28,8 @@ import org.apache.hadoop.yarn.proto.YarnProtos.YarnClusterMetricsProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetClusterMetricsResponseProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetClusterMetricsResponseProtoOrBuilder;
 
-
-    
+@Private
+@Unstable
 public class GetClusterMetricsResponsePBImpl extends GetClusterMetricsResponse {
   GetClusterMetricsResponseProto proto = GetClusterMetricsResponseProto.getDefaultInstance();
   GetClusterMetricsResponseProto.Builder builder = null;

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/GetClusterNodesRequestPBImpl.java

@@ -18,9 +18,13 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.GetClusterNodesRequest;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetClusterNodesRequestProto;
 
+@Private
+@Unstable
 public class GetClusterNodesRequestPBImpl extends GetClusterNodesRequest {
 
   GetClusterNodesRequestProto proto = GetClusterNodesRequestProto.getDefaultInstance();

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/GetClusterNodesResponsePBImpl.java

@@ -22,6 +22,8 @@ import java.util.ArrayList;
 import java.util.Iterator;
 import java.util.List;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.GetClusterNodesResponse;
 import org.apache.hadoop.yarn.api.records.NodeReport;
 import org.apache.hadoop.yarn.api.records.impl.pb.NodeReportPBImpl;
@@ -29,6 +31,8 @@ import org.apache.hadoop.yarn.proto.YarnProtos.NodeReportProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetClusterNodesResponseProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetClusterNodesResponseProtoOrBuilder;
 
+@Private
+@Unstable
 public class GetClusterNodesResponsePBImpl extends GetClusterNodesResponse {
 
   GetClusterNodesResponseProto proto = 

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/GetContainerStatusRequestPBImpl.java

@@ -19,6 +19,8 @@
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.GetContainerStatusRequest;
 import org.apache.hadoop.yarn.api.records.ContainerId;
 import org.apache.hadoop.yarn.api.records.impl.pb.ContainerIdPBImpl;
@@ -26,8 +28,8 @@ import org.apache.hadoop.yarn.proto.YarnProtos.ContainerIdProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetContainerStatusRequestProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetContainerStatusRequestProtoOrBuilder;
 
-
-    
+@Private
+@Unstable
 public class GetContainerStatusRequestPBImpl extends GetContainerStatusRequest {
   GetContainerStatusRequestProto proto = GetContainerStatusRequestProto.getDefaultInstance();
   GetContainerStatusRequestProto.Builder builder = null;

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/GetContainerStatusResponsePBImpl.java

@@ -19,6 +19,8 @@
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.GetContainerStatusResponse;
 import org.apache.hadoop.yarn.api.records.ContainerStatus;
 import org.apache.hadoop.yarn.api.records.impl.pb.ContainerStatusPBImpl;
@@ -26,8 +28,8 @@ import org.apache.hadoop.yarn.proto.YarnProtos.ContainerStatusProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetContainerStatusResponseProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetContainerStatusResponseProtoOrBuilder;
 
-
-    
+@Private
+@Unstable
 public class GetContainerStatusResponsePBImpl extends  GetContainerStatusResponse {
   GetContainerStatusResponseProto proto = GetContainerStatusResponseProto.getDefaultInstance();
   GetContainerStatusResponseProto.Builder builder = null;

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/GetDelegationTokenRequestPBImpl.java

@@ -17,10 +17,14 @@
    */
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.security.proto.SecurityProtos.GetDelegationTokenRequestProto;
 import org.apache.hadoop.security.proto.SecurityProtos.GetDelegationTokenRequestProtoOrBuilder;
 import org.apache.hadoop.yarn.api.protocolrecords.GetDelegationTokenRequest;
 
+@Private
+@Unstable
 public class GetDelegationTokenRequestPBImpl extends GetDelegationTokenRequest {
   
   String renewer;

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/GetDelegationTokenResponsePBImpl.java

@@ -18,6 +18,8 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.security.proto.SecurityProtos.GetDelegationTokenResponseProto;
 import org.apache.hadoop.security.proto.SecurityProtos.GetDelegationTokenResponseProtoOrBuilder;
 import org.apache.hadoop.security.proto.SecurityProtos.TokenProto;
@@ -25,6 +27,8 @@ import org.apache.hadoop.yarn.api.protocolrecords.GetDelegationTokenResponse;
 import org.apache.hadoop.yarn.api.records.Token;
 import org.apache.hadoop.yarn.api.records.impl.pb.TokenPBImpl;
 
+@Private
+@Unstable
 public class GetDelegationTokenResponsePBImpl extends GetDelegationTokenResponse {
 
   Token appToken;

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/GetNewApplicationRequestPBImpl.java

@@ -19,10 +19,13 @@
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.GetNewApplicationRequest;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetNewApplicationRequestProto;
 
-    
+@Private
+@Unstable
 public class GetNewApplicationRequestPBImpl extends GetNewApplicationRequest {
   GetNewApplicationRequestProto proto = GetNewApplicationRequestProto.getDefaultInstance();
   GetNewApplicationRequestProto.Builder builder = null;

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/GetNewApplicationResponsePBImpl.java

@@ -19,6 +19,8 @@
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.GetNewApplicationResponse;
 import org.apache.hadoop.yarn.api.records.ApplicationId;
 import org.apache.hadoop.yarn.api.records.Resource;
@@ -28,7 +30,9 @@ import org.apache.hadoop.yarn.proto.YarnProtos.ApplicationIdProto;
 import org.apache.hadoop.yarn.proto.YarnProtos.ResourceProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetNewApplicationResponseProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetNewApplicationResponseProtoOrBuilder;
-    
+
+@Private
+@Unstable
 public class GetNewApplicationResponsePBImpl extends GetNewApplicationResponse {
   GetNewApplicationResponseProto proto = GetNewApplicationResponseProto.getDefaultInstance();
   GetNewApplicationResponseProto.Builder builder = null;

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/GetQueueInfoRequestPBImpl.java

@@ -18,10 +18,14 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.GetQueueInfoRequest;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetQueueInfoRequestProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetQueueInfoRequestProtoOrBuilder;
 
+@Private
+@Unstable
 public class GetQueueInfoRequestPBImpl extends GetQueueInfoRequest {
 
   GetQueueInfoRequestProto proto = 

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/GetQueueInfoResponsePBImpl.java

@@ -18,6 +18,8 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.GetQueueInfoResponse;
 import org.apache.hadoop.yarn.api.records.QueueInfo;
 import org.apache.hadoop.yarn.api.records.impl.pb.QueueInfoPBImpl;
@@ -25,6 +27,8 @@ import org.apache.hadoop.yarn.proto.YarnProtos.QueueInfoProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetQueueInfoResponseProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetQueueInfoResponseProtoOrBuilder;
 
+@Private
+@Unstable
 public class GetQueueInfoResponsePBImpl extends GetQueueInfoResponse {
 
   QueueInfo queueInfo;

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/GetQueueUserAclsInfoRequestPBImpl.java

@@ -18,9 +18,13 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.GetQueueUserAclsInfoRequest;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetQueueUserAclsInfoRequestProto;
 
+@Private
+@Unstable
 public class GetQueueUserAclsInfoRequestPBImpl extends GetQueueUserAclsInfoRequest {
 
   GetQueueUserAclsInfoRequestProto proto = 

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/GetQueueUserAclsInfoResponsePBImpl.java

@@ -22,6 +22,8 @@ import java.util.ArrayList;
 import java.util.Iterator;
 import java.util.List;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.GetQueueUserAclsInfoResponse;
 import org.apache.hadoop.yarn.api.records.QueueUserACLInfo;
 import org.apache.hadoop.yarn.api.records.impl.pb.QueueUserACLInfoPBImpl;
@@ -29,6 +31,8 @@ import org.apache.hadoop.yarn.proto.YarnProtos.QueueUserACLInfoProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetQueueUserAclsInfoResponseProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.GetQueueUserAclsInfoResponseProtoOrBuilder;
 
+@Private
+@Unstable
 public class GetQueueUserAclsInfoResponsePBImpl extends GetQueueUserAclsInfoResponse {
 
   List<QueueUserACLInfo> queueUserAclsInfoList;

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/KillApplicationRequestPBImpl.java

@@ -19,6 +19,8 @@
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.KillApplicationRequest;
 import org.apache.hadoop.yarn.api.records.ApplicationId;
 import org.apache.hadoop.yarn.api.records.impl.pb.ApplicationIdPBImpl;
@@ -26,8 +28,8 @@ import org.apache.hadoop.yarn.proto.YarnProtos.ApplicationIdProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.KillApplicationRequestProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.KillApplicationRequestProtoOrBuilder;
 
-
-    
+@Private
+@Unstable
 public class KillApplicationRequestPBImpl extends KillApplicationRequest {
   KillApplicationRequestProto proto = KillApplicationRequestProto.getDefaultInstance();
   KillApplicationRequestProto.Builder builder = null;

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/KillApplicationResponsePBImpl.java

@@ -19,11 +19,13 @@
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.KillApplicationResponse;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.KillApplicationResponseProto;
 
-
-    
+@Private
+@Unstable
 public class KillApplicationResponsePBImpl extends KillApplicationResponse {
   KillApplicationResponseProto proto = KillApplicationResponseProto.getDefaultInstance();
   KillApplicationResponseProto.Builder builder = null;
@@ -63,11 +65,4 @@ public class KillApplicationResponsePBImpl extends KillApplicationResponse {
   public String toString() {
     return getProto().toString().replaceAll("\\n", ", ").replaceAll("\\s+", " ");
   }
-
-  private void maybeInitBuilder() {
-    if (viaProto || builder == null) {
-      builder = KillApplicationResponseProto.newBuilder(proto);
-    }
-    viaProto = false;
-  }
 }  

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/RefreshAdminAclsRequestPBImpl.java

@@ -18,9 +18,13 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.RefreshAdminAclsRequest;
 import org.apache.hadoop.yarn.proto.YarnServerResourceManagerServiceProtos.RefreshAdminAclsRequestProto;
 
+@Private
+@Unstable
 public class RefreshAdminAclsRequestPBImpl 
 extends RefreshAdminAclsRequest {
 

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/RefreshAdminAclsResponsePBImpl.java

@@ -18,9 +18,13 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.RefreshAdminAclsResponse;
 import org.apache.hadoop.yarn.proto.YarnServerResourceManagerServiceProtos.RefreshAdminAclsResponseProto;
 
+@Private
+@Unstable
 public class RefreshAdminAclsResponsePBImpl extends RefreshAdminAclsResponse {
 
   RefreshAdminAclsResponseProto proto = RefreshAdminAclsResponseProto.getDefaultInstance();

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/RefreshNodesRequestPBImpl.java

@@ -18,9 +18,13 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.RefreshNodesRequest;
 import org.apache.hadoop.yarn.proto.YarnServerResourceManagerServiceProtos.RefreshNodesRequestProto;
 
+@Private
+@Unstable
 public class RefreshNodesRequestPBImpl extends RefreshNodesRequest {
 
   RefreshNodesRequestProto proto = RefreshNodesRequestProto.getDefaultInstance();

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/RefreshNodesResponsePBImpl.java

@@ -18,9 +18,13 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.RefreshNodesResponse;
 import org.apache.hadoop.yarn.proto.YarnServerResourceManagerServiceProtos.RefreshNodesResponseProto;
 
+@Private
+@Unstable
 public class RefreshNodesResponsePBImpl extends RefreshNodesResponse {
 
   RefreshNodesResponseProto proto = RefreshNodesResponseProto.getDefaultInstance();

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/RefreshQueuesRequestPBImpl.java

@@ -18,9 +18,13 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.RefreshQueuesRequest;
 import org.apache.hadoop.yarn.proto.YarnServerResourceManagerServiceProtos.RefreshQueuesRequestProto;
 
+@Private
+@Unstable
 public class RefreshQueuesRequestPBImpl extends RefreshQueuesRequest {
 
   RefreshQueuesRequestProto proto = RefreshQueuesRequestProto.getDefaultInstance();

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/RefreshQueuesResponsePBImpl.java

@@ -18,9 +18,13 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.RefreshQueuesResponse;
 import org.apache.hadoop.yarn.proto.YarnServerResourceManagerServiceProtos.RefreshQueuesResponseProto;
 
+@Private
+@Unstable
 public class RefreshQueuesResponsePBImpl extends RefreshQueuesResponse {
 
   RefreshQueuesResponseProto proto = RefreshQueuesResponseProto.getDefaultInstance();

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/RefreshServiceAclsRequestPBImpl.java

@@ -18,9 +18,13 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.RefreshServiceAclsRequest;
 import org.apache.hadoop.yarn.proto.YarnServerResourceManagerServiceProtos.RefreshServiceAclsRequestProto;
 
+@Private
+@Unstable
 public class RefreshServiceAclsRequestPBImpl extends RefreshServiceAclsRequest {
 
   RefreshServiceAclsRequestProto proto = 

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/RefreshServiceAclsResponsePBImpl.java

@@ -18,9 +18,13 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.RefreshServiceAclsResponse;
 import org.apache.hadoop.yarn.proto.YarnServerResourceManagerServiceProtos.RefreshServiceAclsResponseProto;
 
+@Private
+@Unstable
 public class RefreshServiceAclsResponsePBImpl extends
     RefreshServiceAclsResponse {
 

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/RefreshSuperUserGroupsConfigurationRequestPBImpl.java

@@ -18,9 +18,13 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.RefreshSuperUserGroupsConfigurationRequest;
 import org.apache.hadoop.yarn.proto.YarnServerResourceManagerServiceProtos.RefreshSuperUserGroupsConfigurationRequestProto;
 
+@Private
+@Unstable
 public class RefreshSuperUserGroupsConfigurationRequestPBImpl 
 extends RefreshSuperUserGroupsConfigurationRequest {
 

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/RefreshSuperUserGroupsConfigurationResponsePBImpl.java

@@ -18,10 +18,13 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.RefreshSuperUserGroupsConfigurationResponse;
-import org.apache.hadoop.yarn.api.records.impl.pb.ProtoBase;
 import org.apache.hadoop.yarn.proto.YarnServerResourceManagerServiceProtos.RefreshSuperUserGroupsConfigurationResponseProto;
 
+@Private
+@Unstable
 public class RefreshSuperUserGroupsConfigurationResponsePBImpl extends RefreshSuperUserGroupsConfigurationResponse {
 
   RefreshSuperUserGroupsConfigurationResponseProto proto = RefreshSuperUserGroupsConfigurationResponseProto.getDefaultInstance();

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/RefreshUserToGroupsMappingsRequestPBImpl.java

@@ -18,9 +18,13 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.RefreshUserToGroupsMappingsRequest;
 import org.apache.hadoop.yarn.proto.YarnServerResourceManagerServiceProtos.RefreshUserToGroupsMappingsRequestProto;
 
+@Private
+@Unstable
 public class RefreshUserToGroupsMappingsRequestPBImpl 
 extends RefreshUserToGroupsMappingsRequest {
 

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/RefreshUserToGroupsMappingsResponsePBImpl.java

@@ -18,9 +18,13 @@
 
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.RefreshUserToGroupsMappingsResponse;
 import org.apache.hadoop.yarn.proto.YarnServerResourceManagerServiceProtos.RefreshUserToGroupsMappingsResponseProto;
 
+@Private
+@Unstable
 public class RefreshUserToGroupsMappingsResponsePBImpl extends RefreshUserToGroupsMappingsResponse {
 
   RefreshUserToGroupsMappingsResponseProto proto = RefreshUserToGroupsMappingsResponseProto.getDefaultInstance();

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/RegisterApplicationMasterRequestPBImpl.java

@@ -19,6 +19,8 @@
 package org.apache.hadoop.yarn.api.protocolrecords.impl.pb;
 
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.RegisterApplicationMasterRequest;
 import org.apache.hadoop.yarn.api.records.ApplicationAttemptId;
 import org.apache.hadoop.yarn.api.records.impl.pb.ApplicationAttemptIdPBImpl;
@@ -26,8 +28,8 @@ import org.apache.hadoop.yarn.proto.YarnProtos.ApplicationAttemptIdProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.RegisterApplicationMasterRequestProto;
 import org.apache.hadoop.yarn.proto.YarnServiceProtos.RegisterApplicationMasterRequestProtoOrBuilder;
 
-
-    
+@Private
+@Unstable
 public class RegisterApplicationMasterRequestPBImpl extends RegisterApplicationMasterRequest {
   RegisterApplicationMasterRequestProto proto = RegisterApplicationMasterRequestProto.getDefaultInstance();
   RegisterApplicationMasterRequestProto.Builder builder = null;

hadoop-yarn-project/hadoop-yarn/hadoop-yarn-api/src/main/java/org/apache/hadoop/yarn/api/protocolrecords/impl/pb/RegisterApplicationMasterResponsePBImpl.java

@@ -25,6 +25,8 @@ import java.util.Iterator;
 import java.util.List;
 import java.util.Map;
 
+import org.apache.hadoop.classification.InterfaceAudience.Private;
+import org.apache.hadoop.classification.InterfaceStability.Unstable;
 import org.apache.hadoop.yarn.api.protocolrecords.RegisterApplicationMasterResponse;
 import org.apache.hadoop.yarn.api.records.ApplicationAccessType;
 import org.apache.hadoop.yarn.api.records.Resource;
@@ -38,6 +40,8 @@ import org.apache.hadoop.yarn.util.ProtoUtils;
 import com.google.protobuf.ByteString;
 
 
+@Private
+@Unstable
 public class RegisterApplicationMasterResponsePBImpl extends
     RegisterApplicationMasterResponse {
   RegisterApplicationMasterResponseProto proto =