Java tutorial
/** * 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. */ package org.apache.hadoop.yarn.client.api; import java.io.IOException; import java.util.EnumSet; import java.util.List; import java.util.Map; import java.util.Set; import org.apache.hadoop.classification.InterfaceAudience; import org.apache.hadoop.classification.InterfaceAudience.Private; import org.apache.hadoop.classification.InterfaceAudience.Public; import org.apache.hadoop.classification.InterfaceStability; import org.apache.hadoop.classification.InterfaceStability.Unstable; import org.apache.hadoop.io.Text; import org.apache.hadoop.service.AbstractService; import org.apache.hadoop.yarn.api.ApplicationClientProtocol; import org.apache.hadoop.yarn.api.protocolrecords.GetApplicationsRequest; import org.apache.hadoop.yarn.api.protocolrecords.GetNewReservationResponse; import org.apache.hadoop.yarn.api.protocolrecords.ReservationDeleteRequest; import org.apache.hadoop.yarn.api.protocolrecords.ReservationDeleteResponse; import org.apache.hadoop.yarn.api.protocolrecords.ReservationListRequest; import org.apache.hadoop.yarn.api.protocolrecords.ReservationListResponse; import org.apache.hadoop.yarn.api.protocolrecords.ReservationSubmissionRequest; import org.apache.hadoop.yarn.api.protocolrecords.ReservationSubmissionResponse; import org.apache.hadoop.yarn.api.protocolrecords.ReservationUpdateRequest; import org.apache.hadoop.yarn.api.protocolrecords.ReservationUpdateResponse; import org.apache.hadoop.yarn.api.protocolrecords.UpdateApplicationTimeoutsRequest; import org.apache.hadoop.yarn.api.protocolrecords.UpdateApplicationTimeoutsResponse; import org.apache.hadoop.yarn.api.records.ApplicationAttemptId; import org.apache.hadoop.yarn.api.records.ApplicationAttemptReport; import org.apache.hadoop.yarn.api.records.ApplicationId; import org.apache.hadoop.yarn.api.records.ApplicationReport; import org.apache.hadoop.yarn.api.records.ApplicationSubmissionContext; import org.apache.hadoop.yarn.api.records.ContainerId; import org.apache.hadoop.yarn.api.records.ContainerReport; import org.apache.hadoop.yarn.api.records.NodeAttribute; import org.apache.hadoop.yarn.api.records.NodeAttributeKey; import org.apache.hadoop.yarn.api.records.NodeAttributeInfo; import org.apache.hadoop.yarn.api.records.NodeId; import org.apache.hadoop.yarn.api.records.NodeLabel; import org.apache.hadoop.yarn.api.records.NodeReport; import org.apache.hadoop.yarn.api.records.NodeState; import org.apache.hadoop.yarn.api.records.NodeToAttributeValue; import org.apache.hadoop.yarn.api.records.Priority; import org.apache.hadoop.yarn.api.records.QueueInfo; import org.apache.hadoop.yarn.api.records.QueueUserACLInfo; import org.apache.hadoop.yarn.api.records.ReservationDefinition; import org.apache.hadoop.yarn.api.records.ReservationId; import org.apache.hadoop.yarn.api.records.Resource; import org.apache.hadoop.yarn.api.records.ResourceTypeInfo; import org.apache.hadoop.yarn.api.records.SignalContainerCommand; import org.apache.hadoop.yarn.api.records.Token; import org.apache.hadoop.yarn.api.records.YarnApplicationState; import org.apache.hadoop.yarn.api.records.YarnClusterMetrics; import org.apache.hadoop.yarn.client.api.impl.YarnClientImpl; import org.apache.hadoop.yarn.exceptions.ApplicationAttemptNotFoundException; import org.apache.hadoop.yarn.exceptions.ApplicationIdNotProvidedException; import org.apache.hadoop.yarn.exceptions.ApplicationNotFoundException; import org.apache.hadoop.yarn.exceptions.ContainerNotFoundException; import org.apache.hadoop.yarn.exceptions.YARNFeatureNotEnabledException; import org.apache.hadoop.yarn.exceptions.YarnException; import org.apache.hadoop.yarn.security.AMRMTokenIdentifier; @InterfaceAudience.Public @InterfaceStability.Stable public abstract class YarnClient extends AbstractService { /** * Create a new instance of YarnClient. */ @Public public static YarnClient createYarnClient() { YarnClient client = new YarnClientImpl(); return client; } @Private protected YarnClient(String name) { super(name); } /** * <p> * Obtain a {@link YarnClientApplication} for a new application, * which in turn contains the {@link ApplicationSubmissionContext} and * {@link org.apache.hadoop.yarn.api.protocolrecords.GetNewApplicationResponse} * objects. * </p> * * @return {@link YarnClientApplication} built for a new application * @throws YarnException * @throws IOException */ public abstract YarnClientApplication createApplication() throws YarnException, IOException; /** * <p> * Submit a new application to <code>YARN.</code> It is a blocking call - it * will not return {@link ApplicationId} until the submitted application is * submitted successfully and accepted by the ResourceManager. * </p> * * <p> * Users should provide an {@link ApplicationId} as part of the parameter * {@link ApplicationSubmissionContext} when submitting a new application, * otherwise it will throw the {@link ApplicationIdNotProvidedException}. * </p> * * <p>This internally calls {@link ApplicationClientProtocol#submitApplication * (SubmitApplicationRequest)}, and after that, it internally invokes * {@link ApplicationClientProtocol#getApplicationReport * (GetApplicationReportRequest)} and waits till it can make sure that the * application gets properly submitted. If RM fails over or RM restart * happens before ResourceManager saves the application's state, * {@link ApplicationClientProtocol * #getApplicationReport(GetApplicationReportRequest)} will throw * the {@link ApplicationNotFoundException}. This API automatically resubmits * the application with the same {@link ApplicationSubmissionContext} when it * catches the {@link ApplicationNotFoundException}</p> * * @param appContext * {@link ApplicationSubmissionContext} containing all the details * needed to submit a new application * @return {@link ApplicationId} of the accepted application * @throws YarnException * @throws IOException * @see #createApplication() */ public abstract ApplicationId submitApplication(ApplicationSubmissionContext appContext) throws YarnException, IOException; /** * <p> * Fail an application attempt identified by given ID. * </p> * * @param applicationAttemptId * {@link ApplicationAttemptId} of the attempt to fail. * @throws YarnException * in case of errors or if YARN rejects the request due to * access-control restrictions. * @throws IOException * @see #getQueueAclsInfo() */ public abstract void failApplicationAttempt(ApplicationAttemptId applicationAttemptId) throws YarnException, IOException; /** * <p> * Kill an application identified by given ID. * </p> * * @param applicationId * {@link ApplicationId} of the application that needs to be killed * @throws YarnException * in case of errors or if YARN rejects the request due to * access-control restrictions. * @throws IOException * @see #getQueueAclsInfo() */ public abstract void killApplication(ApplicationId applicationId) throws YarnException, IOException; /** * <p> * Kill an application identified by given ID. * </p> * @param applicationId {@link ApplicationId} of the application that needs to * be killed * @param diagnostics for killing an application. * @throws YarnException in case of errors or if YARN rejects the request due * to access-control restrictions. * @throws IOException */ public abstract void killApplication(ApplicationId applicationId, String diagnostics) throws YarnException, IOException; /** * <p> * Get a report of the given Application. * </p> * * <p> * In secure mode, <code>YARN</code> verifies access to the application, queue * etc. before accepting the request. * </p> * * <p> * If the user does not have <code>VIEW_APP</code> access then the following * fields in the report will be set to stubbed values: * <ul> * <li>host - set to "N/A"</li> * <li>RPC port - set to -1</li> * <li>client token - set to "N/A"</li> * <li>diagnostics - set to "N/A"</li> * <li>tracking URL - set to "N/A"</li> * <li>original tracking URL - set to "N/A"</li> * <li>resource usage report - all values are -1</li> * </ul> * * @param appId * {@link ApplicationId} of the application that needs a report * @return application report * @throws YarnException * @throws IOException */ public abstract ApplicationReport getApplicationReport(ApplicationId appId) throws YarnException, IOException; /** * Get the AMRM token of the application. * <p> * The AMRM token is required for AM to RM scheduling operations. For * managed Application Masters YARN takes care of injecting it. For unmanaged * Applications Masters, the token must be obtained via this method and set * in the {@link org.apache.hadoop.security.UserGroupInformation} of the * current user. * <p> * The AMRM token will be returned only if all the following conditions are * met: * <ul> * <li>the requester is the owner of the ApplicationMaster</li> * <li>the application master is an unmanaged ApplicationMaster</li> * <li>the application master is in ACCEPTED state</li> * </ul> * Else this method returns NULL. * * @param appId {@link ApplicationId} of the application to get the AMRM token * @return the AMRM token if available * @throws YarnException * @throws IOException */ public abstract org.apache.hadoop.security.token.Token<AMRMTokenIdentifier> getAMRMToken(ApplicationId appId) throws YarnException, IOException; /** * <p> * Get a report (ApplicationReport) of all Applications in the cluster. * </p> * * <p> * If the user does not have <code>VIEW_APP</code> access for an application * then the corresponding report will be filtered as described in * {@link #getApplicationReport(ApplicationId)}. * </p> * * @return a list of reports of all running applications * @throws YarnException * @throws IOException */ public abstract List<ApplicationReport> getApplications() throws YarnException, IOException; /** * <p> * Get a report (ApplicationReport) of Applications * matching the given application types in the cluster. * </p> * * <p> * If the user does not have <code>VIEW_APP</code> access for an application * then the corresponding report will be filtered as described in * {@link #getApplicationReport(ApplicationId)}. * </p> * * @param applicationTypes set of application types you are interested in * @return a list of reports of applications * @throws YarnException * @throws IOException */ public abstract List<ApplicationReport> getApplications(Set<String> applicationTypes) throws YarnException, IOException; /** * <p> * Get a report (ApplicationReport) of Applications matching the given * application states in the cluster. * </p> * * <p> * If the user does not have <code>VIEW_APP</code> access for an application * then the corresponding report will be filtered as described in * {@link #getApplicationReport(ApplicationId)}. * </p> * * @param applicationStates set of application states you are interested in * @return a list of reports of applications * @throws YarnException * @throws IOException */ public abstract List<ApplicationReport> getApplications(EnumSet<YarnApplicationState> applicationStates) throws YarnException, IOException; /** * <p> * Get a report (ApplicationReport) of Applications matching the given * application types and application states in the cluster. * </p> * * <p> * If the user does not have <code>VIEW_APP</code> access for an application * then the corresponding report will be filtered as described in * {@link #getApplicationReport(ApplicationId)}. * </p> * * @param applicationTypes set of application types you are interested in * @param applicationStates set of application states you are interested in * @return a list of reports of applications * @throws YarnException * @throws IOException */ public abstract List<ApplicationReport> getApplications(Set<String> applicationTypes, EnumSet<YarnApplicationState> applicationStates) throws YarnException, IOException; /** * <p> * Get a report (ApplicationReport) of Applications matching the given * application types, application states and application tags in the cluster. * </p> * * <p> * If the user does not have <code>VIEW_APP</code> access for an application * then the corresponding report will be filtered as described in * {@link #getApplicationReport(ApplicationId)}. * </p> * * @param applicationTypes set of application types you are interested in * @param applicationStates set of application states you are interested in * @param applicationTags set of application tags you are interested in * @return a list of reports of applications * @throws YarnException * @throws IOException */ public abstract List<ApplicationReport> getApplications(Set<String> applicationTypes, EnumSet<YarnApplicationState> applicationStates, Set<String> applicationTags) throws YarnException, IOException; /** * <p> * Get a report (ApplicationReport) of Applications matching the given users, * queues, application types and application states in the cluster. If any of * the params is set to null, it is not used when filtering. * </p> * * <p> * If the user does not have <code>VIEW_APP</code> access for an application * then the corresponding report will be filtered as described in * {@link #getApplicationReport(ApplicationId)}. * </p> * * @param queues set of queues you are interested in * @param users set of users you are interested in * @param applicationTypes set of application types you are interested in * @param applicationStates set of application states you are interested in * @return a list of reports of applications * @throws YarnException * @throws IOException */ public abstract List<ApplicationReport> getApplications(Set<String> queues, Set<String> users, Set<String> applicationTypes, EnumSet<YarnApplicationState> applicationStates) throws YarnException, IOException; /** * <p> * Get a list of ApplicationReports that match the given * {@link GetApplicationsRequest}. *</p> * * <p> * If the user does not have <code>VIEW_APP</code> access for an application * then the corresponding report will be filtered as described in * {@link #getApplicationReport(ApplicationId)}. * </p> * * @param request the request object to get the list of applications. * @return The list of ApplicationReports that match the request * @throws YarnException Exception specific to YARN. * @throws IOException Exception mostly related to connection errors. */ public List<ApplicationReport> getApplications(GetApplicationsRequest request) throws YarnException, IOException { throw new UnsupportedOperationException( "The sub-class extending " + YarnClient.class.getName() + " is expected to implement this !"); } /** * <p> * Get metrics ({@link YarnClusterMetrics}) about the cluster. * </p> * * @return cluster metrics * @throws YarnException * @throws IOException */ public abstract YarnClusterMetrics getYarnClusterMetrics() throws YarnException, IOException; /** * <p> * Get a report of nodes ({@link NodeReport}) in the cluster. * </p> * * @param states The {@link NodeState}s to filter on. If no filter states are * given, nodes in all states will be returned. * @return A list of node reports * @throws YarnException * @throws IOException */ public abstract List<NodeReport> getNodeReports(NodeState... states) throws YarnException, IOException; /** * <p> * Get a delegation token so as to be able to talk to YARN using those tokens. * * @param renewer * Address of the renewer who can renew these tokens when needed by * securely talking to YARN. * @return a delegation token ({@link Token}) that can be used to * talk to YARN * @throws YarnException * @throws IOException */ public abstract Token getRMDelegationToken(Text renewer) throws YarnException, IOException; /** * <p> * Get information ({@link QueueInfo}) about a given <em>queue</em>. * </p> * * @param queueName * Name of the queue whose information is needed * @return queue information * @throws YarnException * in case of errors or if YARN rejects the request due to * access-control restrictions. * @throws IOException */ public abstract QueueInfo getQueueInfo(String queueName) throws YarnException, IOException; /** * <p> * Get information ({@link QueueInfo}) about all queues, recursively if there * is a hierarchy * </p> * * @return a list of queue-information for all queues * @throws YarnException * @throws IOException */ public abstract List<QueueInfo> getAllQueues() throws YarnException, IOException; /** * <p> * Get information ({@link QueueInfo}) about top level queues. * </p> * * @return a list of queue-information for all the top-level queues * @throws YarnException * @throws IOException */ public abstract List<QueueInfo> getRootQueueInfos() throws YarnException, IOException; /** * <p> * Get information ({@link QueueInfo}) about all the immediate children queues * of the given queue * </p> * * @param parent * Name of the queue whose child-queues' information is needed * @return a list of queue-information for all queues who are direct children * of the given parent queue. * @throws YarnException * @throws IOException */ public abstract List<QueueInfo> getChildQueueInfos(String parent) throws YarnException, IOException; /** * <p> * Get information about <em>acls</em> for <em>current user</em> on all the * existing queues. * </p> * * @return a list of queue acls ({@link QueueUserACLInfo}) for * <em>current user</em> * @throws YarnException * @throws IOException */ public abstract List<QueueUserACLInfo> getQueueAclsInfo() throws YarnException, IOException; /** * <p> * Get a report of the given ApplicationAttempt. * </p> * * <p> * In secure mode, <code>YARN</code> verifies access to the application, queue * etc. before accepting the request. * </p> * * @param applicationAttemptId * {@link ApplicationAttemptId} of the application attempt that needs * a report * @return application attempt report * @throws YarnException * @throws ApplicationAttemptNotFoundException if application attempt * not found * @throws IOException */ public abstract ApplicationAttemptReport getApplicationAttemptReport(ApplicationAttemptId applicationAttemptId) throws YarnException, IOException; /** * <p> * Get a report of all (ApplicationAttempts) of Application in the cluster. * </p> * * @param applicationId application id of the app * @return a list of reports for all application attempts for specified * application. * @throws YarnException * @throws IOException */ public abstract List<ApplicationAttemptReport> getApplicationAttempts(ApplicationId applicationId) throws YarnException, IOException; /** * <p> * Get a report of the given Container. * </p> * * <p> * In secure mode, <code>YARN</code> verifies access to the application, queue * etc. before accepting the request. * </p> * * @param containerId * {@link ContainerId} of the container that needs a report * @return container report * @throws YarnException * @throws ContainerNotFoundException if container not found. * @throws IOException */ public abstract ContainerReport getContainerReport(ContainerId containerId) throws YarnException, IOException; /** * <p> * Get a report of all (Containers) of ApplicationAttempt in the cluster. * </p> * * @param applicationAttemptId application attempt id * @return a list of reports of all containers for specified application * attempts * @throws YarnException * @throws IOException */ public abstract List<ContainerReport> getContainers(ApplicationAttemptId applicationAttemptId) throws YarnException, IOException; /** * <p> * Attempts to move the given application to the given queue. * </p> * * @param appId * Application to move. * @param queue * Queue to place it in to. * @throws YarnException * @throws IOException */ public abstract void moveApplicationAcrossQueues(ApplicationId appId, String queue) throws YarnException, IOException; /** * <p> * Obtain a {@link GetNewReservationResponse} for a new reservation, * which contains the {@link ReservationId} object. * </p> * * @return The {@link GetNewReservationResponse} containing a new * {@link ReservationId} object. * @throws YarnException if reservation cannot be created. * @throws IOException if reservation cannot be created. */ public abstract GetNewReservationResponse createReservation() throws YarnException, IOException; /** * <p> * The interface used by clients to submit a new reservation to the * {@code ResourceManager}. * </p> * * <p> * The client packages all details of its request in a * {@link ReservationSubmissionRequest} object. This contains information * about the amount of capacity, temporal constraints, and gang needs. * Furthermore, the reservation might be composed of multiple stages, with * ordering dependencies among them. * </p> * * <p> * In order to respond, a new admission control component in the * {@code ResourceManager} performs an analysis of the resources that have * been committed over the period of time the user is requesting, verify that * the user requests can be fulfilled, and that it respect a sharing policy * (e.g., {@code CapacityOverTimePolicy}). Once it has positively determined * that the ReservationRequest is satisfiable the {@code ResourceManager} * answers with a {@link ReservationSubmissionResponse} that includes a * {@link ReservationId}. Upon failure to find a valid allocation the response * is an exception with the message detailing the reason of failure. * </p> * * <p> * The semantics guarantees that the {@link ReservationId} returned, * corresponds to a valid reservation existing in the time-range request by * the user. The amount of capacity dedicated to such reservation can vary * overtime, depending of the allocation that has been determined. But it is * guaranteed to satisfy all the constraint expressed by the user in the * {@link ReservationDefinition} * </p> * * @param request request to submit a new Reservation * @return response contains the {@link ReservationId} on accepting the * submission * @throws YarnException if the reservation cannot be created successfully * @throws IOException * */ @Public @Unstable public abstract ReservationSubmissionResponse submitReservation(ReservationSubmissionRequest request) throws YarnException, IOException; /** * <p> * The interface used by clients to update an existing Reservation. This is * referred to as a re-negotiation process, in which a user that has * previously submitted a Reservation. * </p> * * <p> * The allocation is attempted by virtually substituting all previous * allocations related to this Reservation with new ones, that satisfy the new * {@link ReservationDefinition}. Upon success the previous allocation is * atomically substituted by the new one, and on failure (i.e., if the system * cannot find a valid allocation for the updated request), the previous * allocation remains valid. * </p> * * @param request to update an existing Reservation (the * {@link ReservationUpdateRequest} should refer to an existing valid * {@link ReservationId}) * @return response empty on successfully updating the existing reservation * @throws YarnException if the request is invalid or reservation cannot be * updated successfully * @throws IOException * */ @Public @Unstable public abstract ReservationUpdateResponse updateReservation(ReservationUpdateRequest request) throws YarnException, IOException; /** * <p> * The interface used by clients to remove an existing Reservation. * </p> * * @param request to remove an existing Reservation (the * {@link ReservationDeleteRequest} should refer to an existing valid * {@link ReservationId}) * @return response empty on successfully deleting the existing reservation * @throws YarnException if the request is invalid or reservation cannot be * deleted successfully * @throws IOException * */ @Public @Unstable public abstract ReservationDeleteResponse deleteReservation(ReservationDeleteRequest request) throws YarnException, IOException; /** * <p> * The interface used by clients to get the list of reservations in a plan. * The reservationId will be used to search for reservations to list if it is * provided. Otherwise, it will select active reservations within the * startTime and endTime (inclusive). * </p> * * @param request to list reservations in a plan. Contains fields to select * String queue, ReservationId reservationId, long startTime, * long endTime, and a bool includeReservationAllocations. * * queue: Required. Cannot be null or empty. Refers to the * reservable queue in the scheduler that was selected when * creating a reservation submission * {@link ReservationSubmissionRequest}. * * reservationId: Optional. If provided, other fields will * be ignored. * * startTime: Optional. If provided, only reservations that * end after the startTime will be selected. This defaults * to 0 if an invalid number is used. * * endTime: Optional. If provided, only reservations that * start on or before endTime will be selected. This defaults * to Long.MAX_VALUE if an invalid number is used. * * includeReservationAllocations: Optional. Flag that * determines whether the entire reservation allocations are * to be returned. Reservation allocations are subject to * change in the event of re-planning as described by * {@link ReservationDefinition}. * * @return response that contains information about reservations that are * being searched for. * @throws YarnException if the request is invalid * @throws IOException if the request failed otherwise * */ @Public @Unstable public abstract ReservationListResponse listReservations(ReservationListRequest request) throws YarnException, IOException; /** * <p> * The interface used by client to get node to labels mappings in existing cluster * </p> * * @return node to labels mappings * @throws YarnException * @throws IOException */ @Public @Unstable public abstract Map<NodeId, Set<String>> getNodeToLabels() throws YarnException, IOException; /** * <p> * The interface used by client to get labels to nodes mapping * in existing cluster * </p> * * @return node to labels mappings * @throws YarnException * @throws IOException */ @Public @Unstable public abstract Map<String, Set<NodeId>> getLabelsToNodes() throws YarnException, IOException; /** * <p> * The interface used by client to get labels to nodes mapping * for specified labels in existing cluster * </p> * * @param labels labels for which labels to nodes mapping has to be retrieved * @return labels to nodes mappings for specific labels * @throws YarnException * @throws IOException */ @Public @Unstable public abstract Map<String, Set<NodeId>> getLabelsToNodes(Set<String> labels) throws YarnException, IOException; /** * <p> * The interface used by client to get node labels in the cluster * </p> * * @return cluster node labels collection * @throws YarnException when there is a failure in * {@link ApplicationClientProtocol} * @throws IOException when there is a failure in * {@link ApplicationClientProtocol} */ @Public @Unstable public abstract List<NodeLabel> getClusterNodeLabels() throws YarnException, IOException; /** * <p> * The interface used by client to set priority of an application * </p> * @param applicationId * @param priority * @return updated priority of an application. * @throws YarnException * @throws IOException */ @Public @Unstable public abstract Priority updateApplicationPriority(ApplicationId applicationId, Priority priority) throws YarnException, IOException; /** * <p> * Signal a container identified by given ID. * </p> * * @param containerId * {@link ContainerId} of the container that needs to be signaled * @param command the signal container command * @throws YarnException * @throws IOException */ public abstract void signalToContainer(ContainerId containerId, SignalContainerCommand command) throws YarnException, IOException; @Public @Unstable public UpdateApplicationTimeoutsResponse updateApplicationTimeouts(UpdateApplicationTimeoutsRequest request) throws YarnException, IOException { throw new UnsupportedOperationException( "The sub-class extending " + YarnClient.class.getName() + " is expected to implement this !"); } /** * <p> * Get the resource profiles available in the RM. * </p> * @return a Map of the resource profile names to their capabilities * @throws YARNFeatureNotEnabledException if resource-profile is disabled * @throws YarnException if any error happens inside YARN * @throws IOException in case of other errors */ @Public @Unstable public abstract Map<String, Resource> getResourceProfiles() throws YarnException, IOException; /** * <p> * Get the details of a specific resource profile from the RM. * </p> * @param profile the profile name * @return resource profile name with its capabilities * @throws YARNFeatureNotEnabledException if resource-profile is disabled * @throws YarnException if any error happens inside YARN * @throws IOException in case of other others */ @Public @Unstable public abstract Resource getResourceProfile(String profile) throws YarnException, IOException; /** * <p> * Get available resource types supported by RM. * </p> * @return list of supported resource types with detailed information * @throws YarnException if any issue happens inside YARN * @throws IOException in case of other others */ @Public @Unstable public abstract List<ResourceTypeInfo> getResourceTypeInfo() throws YarnException, IOException; /** * <p> * The interface used by client to get node attributes in the cluster. * </p> * * @return cluster node attributes collection * @throws YarnException when there is a failure in * {@link ApplicationClientProtocol} * @throws IOException when there is a failure in * {@link ApplicationClientProtocol} */ @Public @Unstable public abstract Set<NodeAttributeInfo> getClusterAttributes() throws YarnException, IOException; /** * <p> * The interface used by client to get mapping of AttributeKey to associated * NodeToAttributeValue list for specified node attributeKeys in the cluster. * </p> * * @param attributes AttributeKeys for which associated NodeToAttributeValue * mapping value has to be retrieved. If empty or null is set then * will return mapping for all attributeKeys in the cluster * @return mapping of AttributeKey to List of associated * NodeToAttributeValue's. * @throws YarnException * @throws IOException */ @Public @Unstable public abstract Map<NodeAttributeKey, List<NodeToAttributeValue>> getAttributesToNodes( Set<NodeAttributeKey> attributes) throws YarnException, IOException; /** * <p> * The interface used by client to get all node to attribute mapping in * existing cluster. * </p> * * @param hostNames HostNames for which host to attributes mapping has to * be retrived.If empty or null is set then will return * all nodes to attributes mapping in cluster. * @return Node to attribute mappings * @throws YarnException * @throws IOException */ @Public @Unstable public abstract Map<String, Set<NodeAttribute>> getNodeToAttributes(Set<String> hostNames) throws YarnException, IOException; }