|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.apache.hadoop.service.AbstractService org.apache.hadoop.yarn.client.api.YarnClient
@InterfaceAudience.Public @InterfaceStability.Stable public abstract class YarnClient
Constructor Summary | |
---|---|
protected |
YarnClient(String name)
|
Method Summary | |
---|---|
abstract YarnClientApplication |
createApplication()
Obtain a YarnClientApplication for a new application,
which in turn contains the ApplicationSubmissionContext and
GetNewApplicationResponse
objects. |
static YarnClient |
createYarnClient()
Create a new instance of YarnClient. |
abstract List<QueueInfo> |
getAllQueues()
Get information ( QueueInfo ) about all queues, recursively if there
is a hierarchy |
abstract org.apache.hadoop.security.token.Token<AMRMTokenIdentifier> |
getAMRMToken(ApplicationId appId)
Get the AMRM token of the application. |
abstract ApplicationAttemptReport |
getApplicationAttemptReport(ApplicationAttemptId applicationAttemptId)
Get a report of the given ApplicationAttempt. |
abstract List<ApplicationAttemptReport> |
getApplicationAttempts(ApplicationId applicationId)
Get a report of all (ApplicationAttempts) of Application in the cluster. |
abstract ApplicationReport |
getApplicationReport(ApplicationId appId)
Get a report of the given Application. |
abstract List<ApplicationReport> |
getApplications()
Get a report (ApplicationReport) of all Applications in the cluster. |
abstract List<ApplicationReport> |
getApplications(EnumSet<YarnApplicationState> applicationStates)
Get a report (ApplicationReport) of Applications matching the given application states in the cluster. |
abstract List<ApplicationReport> |
getApplications(Set<String> applicationTypes)
Get a report (ApplicationReport) of Applications matching the given application types in the cluster. |
abstract List<ApplicationReport> |
getApplications(Set<String> applicationTypes,
EnumSet<YarnApplicationState> applicationStates)
Get a report (ApplicationReport) of Applications matching the given application types and application states in the cluster. |
abstract List<QueueInfo> |
getChildQueueInfos(String parent)
Get information ( QueueInfo ) about all the immediate children queues
of the given queue |
abstract ContainerReport |
getContainerReport(ContainerId containerId)
Get a report of the given Container. |
abstract List<ContainerReport> |
getContainers(ApplicationAttemptId applicationAttemptId)
Get a report of all (Containers) of ApplicationAttempt in the cluster. |
abstract List<NodeReport> |
getNodeReports(NodeState... states)
Get a report of nodes ( NodeReport ) in the cluster. |
abstract List<QueueUserACLInfo> |
getQueueAclsInfo()
Get information about acls for current user on all the existing queues. |
abstract QueueInfo |
getQueueInfo(String queueName)
Get information ( QueueInfo ) about a given queue. |
abstract Token |
getRMDelegationToken(Text renewer)
Get a delegation token so as to be able to talk to YARN using those tokens. |
abstract List<QueueInfo> |
getRootQueueInfos()
Get information ( QueueInfo ) about top level queues. |
abstract YarnClusterMetrics |
getYarnClusterMetrics()
Get metrics ( YarnClusterMetrics ) about the cluster. |
abstract void |
killApplication(ApplicationId applicationId)
Kill an application identified by given ID. |
abstract void |
moveApplicationAcrossQueues(ApplicationId appId,
String queue)
Attempts to move the given application to the given queue. |
abstract ApplicationId |
submitApplication(ApplicationSubmissionContext appContext)
Submit a new application to YARN. It is a blocking call - it
will not return ApplicationId until the submitted application is
submitted successfully and accepted by the ResourceManager. |
Methods inherited from class org.apache.hadoop.service.AbstractService |
---|
close, getBlockers, getConfig, getFailureCause, getFailureState, getLifecycleHistory, getName, getServiceState, getStartTime, init, isInState, noteFailure, putBlocker, registerGlobalListener, registerServiceListener, removeBlocker, serviceInit, serviceStart, serviceStop, setConfig, start, stop, toString, unregisterGlobalListener, unregisterServiceListener, waitForServiceToStop |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
@InterfaceAudience.Private protected YarnClient(String name)
Method Detail |
---|
@InterfaceAudience.Public public static YarnClient createYarnClient()
public abstract YarnClientApplication createApplication() throws YarnException, IOException
Obtain a YarnClientApplication
for a new application,
which in turn contains the ApplicationSubmissionContext
and
GetNewApplicationResponse
objects.
YarnClientApplication
built for a new application
YarnException
IOException
public abstract ApplicationId submitApplication(ApplicationSubmissionContext appContext) throws YarnException, IOException
Submit a new application to YARN.
It is a blocking call - it
will not return ApplicationId
until the submitted application is
submitted successfully and accepted by the ResourceManager.
Users should provide an ApplicationId
as part of the parameter
ApplicationSubmissionContext
when submitting a new application,
otherwise it will throw the ApplicationIdNotProvidedException
.
This internally calls (SubmitApplicationRequest)
, and after that, it internally invokes
(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,
#getApplicationReport(GetApplicationReportRequest)
will throw
the ApplicationNotFoundException
. This API automatically resubmits
the application with the same ApplicationSubmissionContext
when it
catches the ApplicationNotFoundException
appContext
- ApplicationSubmissionContext
containing all the details
needed to submit a new application
ApplicationId
of the accepted application
YarnException
IOException
createApplication()
public abstract void killApplication(ApplicationId applicationId) throws YarnException, IOException
Kill an application identified by given ID.
applicationId
- ApplicationId
of the application that needs to be killed
YarnException
- in case of errors or if YARN rejects the request due to
access-control restrictions.
IOException
getQueueAclsInfo()
public abstract ApplicationReport getApplicationReport(ApplicationId appId) throws YarnException, IOException
Get a report of the given Application.
In secure mode, YARN
verifies access to the application, queue
etc. before accepting the request.
If the user does not have VIEW_APP
access then the following
fields in the report will be set to stubbed values:
appId
- ApplicationId
of the application that needs a report
YarnException
IOException
public abstract org.apache.hadoop.security.token.Token<AMRMTokenIdentifier> getAMRMToken(ApplicationId appId) throws YarnException, IOException
UserGroupInformation
of the
current user.
The AMRM token will be returned only if all the following conditions are
met:
appId
- ApplicationId
of the application to get the AMRM token
YarnException
IOException
public abstract List<ApplicationReport> getApplications() throws YarnException, IOException
Get a report (ApplicationReport) of all Applications in the cluster.
If the user does not have VIEW_APP
access for an application
then the corresponding report will be filtered as described in
getApplicationReport(ApplicationId)
.
YarnException
IOException
public abstract List<ApplicationReport> getApplications(Set<String> applicationTypes) throws YarnException, IOException
Get a report (ApplicationReport) of Applications matching the given application types in the cluster.
If the user does not have VIEW_APP
access for an application
then the corresponding report will be filtered as described in
getApplicationReport(ApplicationId)
.
applicationTypes
-
YarnException
IOException
public abstract List<ApplicationReport> getApplications(EnumSet<YarnApplicationState> applicationStates) throws YarnException, IOException
Get a report (ApplicationReport) of Applications matching the given application states in the cluster.
If the user does not have VIEW_APP
access for an application
then the corresponding report will be filtered as described in
getApplicationReport(ApplicationId)
.
applicationStates
-
YarnException
IOException
public abstract List<ApplicationReport> getApplications(Set<String> applicationTypes, EnumSet<YarnApplicationState> applicationStates) throws YarnException, IOException
Get a report (ApplicationReport) of Applications matching the given application types and application states in the cluster.
If the user does not have VIEW_APP
access for an application
then the corresponding report will be filtered as described in
getApplicationReport(ApplicationId)
.
applicationTypes
- applicationStates
-
YarnException
IOException
public abstract YarnClusterMetrics getYarnClusterMetrics() throws YarnException, IOException
Get metrics (YarnClusterMetrics
) about the cluster.
YarnException
IOException
public abstract List<NodeReport> getNodeReports(NodeState... states) throws YarnException, IOException
Get a report of nodes (NodeReport
) in the cluster.
states
- The NodeState
s to filter on. If no filter states are
given, nodes in all states will be returned.
YarnException
IOException
public abstract Token getRMDelegationToken(Text renewer) throws YarnException, IOException
Get a delegation token so as to be able to talk to YARN using those tokens.
renewer
- Address of the renewer who can renew these tokens when needed by
securely talking to YARN.
Token
) that can be used to
talk to YARN
YarnException
IOException
public abstract QueueInfo getQueueInfo(String queueName) throws YarnException, IOException
Get information (QueueInfo
) about a given queue.
queueName
- Name of the queue whose information is needed
YarnException
- in case of errors or if YARN rejects the request due to
access-control restrictions.
IOException
public abstract List<QueueInfo> getAllQueues() throws YarnException, IOException
Get information (QueueInfo
) about all queues, recursively if there
is a hierarchy
YarnException
IOException
public abstract List<QueueInfo> getRootQueueInfos() throws YarnException, IOException
Get information (QueueInfo
) about top level queues.
YarnException
IOException
public abstract List<QueueInfo> getChildQueueInfos(String parent) throws YarnException, IOException
Get information (QueueInfo
) about all the immediate children queues
of the given queue
parent
- Name of the queue whose child-queues' information is needed
YarnException
IOException
public abstract List<QueueUserACLInfo> getQueueAclsInfo() throws YarnException, IOException
Get information about acls for current user on all the existing queues.
QueueUserACLInfo
) for
current user
YarnException
IOException
public abstract ApplicationAttemptReport getApplicationAttemptReport(ApplicationAttemptId applicationAttemptId) throws YarnException, IOException
Get a report of the given ApplicationAttempt.
In secure mode, YARN
verifies access to the application, queue
etc. before accepting the request.
applicationAttemptId
- ApplicationAttemptId
of the application attempt that needs
a report
YarnException
{@link
- ApplicationAttemptNotFoundException} if application attempt
not found
IOException
public abstract List<ApplicationAttemptReport> getApplicationAttempts(ApplicationId applicationId) throws YarnException, IOException
Get a report of all (ApplicationAttempts) of Application in the cluster.
applicationId
-
YarnException
IOException
public abstract ContainerReport getContainerReport(ContainerId containerId) throws YarnException, IOException
Get a report of the given Container.
In secure mode, YARN
verifies access to the application, queue
etc. before accepting the request.
containerId
- ContainerId
of the container that needs a report
YarnException
{@link
- ContainerNotFoundException} if container not found.
IOException
public abstract List<ContainerReport> getContainers(ApplicationAttemptId applicationAttemptId) throws YarnException, IOException
Get a report of all (Containers) of ApplicationAttempt in the cluster.
applicationAttemptId
-
YarnException
IOException
public abstract void moveApplicationAcrossQueues(ApplicationId appId, String queue) throws YarnException, IOException
Attempts to move the given application to the given queue.
appId
- Application to move.queue
- Queue to place it in to.
YarnException
IOException
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |