Return-Path:
X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io
Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io
Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183])
by cust-asf2.ponee.io (Postfix) with ESMTP id 3D88E200D30
for ; Mon, 30 Oct 2017 23:16:21 +0100 (CET)
Received: by cust-asf.ponee.io (Postfix)
id 3C0A8160BFB; Mon, 30 Oct 2017 22:16:21 +0000 (UTC)
Delivered-To: archive-asf-public@cust-asf.ponee.io
Received: from mail.apache.org (hermes.apache.org [140.211.11.3])
by cust-asf.ponee.io (Postfix) with SMTP id B581F160BE4
for ; Mon, 30 Oct 2017 23:16:18 +0100 (CET)
Received: (qmail 84693 invoked by uid 500); 30 Oct 2017 22:16:17 -0000
Mailing-List: contact common-commits-help@hadoop.apache.org; run by ezmlm
Precedence: bulk
List-Help:
List-Unsubscribe:
List-Post:
List-Id:
Delivered-To: mailing list common-commits@hadoop.apache.org
Received: (qmail 84608 invoked by uid 99); 30 Oct 2017 22:16:17 -0000
Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23)
by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 30 Oct 2017 22:16:17 +0000
Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33)
id E60D1DFE15; Mon, 30 Oct 2017 22:16:14 +0000 (UTC)
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
From: junping_du@apache.org
To: common-commits@hadoop.apache.org
Date: Mon, 30 Oct 2017 22:16:19 -0000
Message-Id:
In-Reply-To:
References:
X-Mailer: ASF-Git Admin Mailer
Subject: [6/7] hadoop git commit: HADOOP-14990. Clean up jdiff xml files added
for 2.8.2 release.
archived-at: Mon, 30 Oct 2017 22:16:21 -0000
http://git-wip-us.apache.org/repos/asf/hadoop/blob/a8083aaa/hadoop-yarn-project/hadoop-yarn/dev-support/Apache_Hadoop_YARN_Client_2.8.2.xml
----------------------------------------------------------------------
diff --git a/hadoop-yarn-project/hadoop-yarn/dev-support/Apache_Hadoop_YARN_Client_2.8.2.xml b/hadoop-yarn-project/hadoop-yarn/dev-support/Apache_Hadoop_YARN_Client_2.8.2.xml
deleted file mode 100644
index f95a17f..0000000
--- a/hadoop-yarn-project/hadoop-yarn/dev-support/Apache_Hadoop_YARN_Client_2.8.2.xml
+++ /dev/null
@@ -1,2316 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 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:
-
- - host - set to "N/A"
- - RPC port - set to -1
- - client token - set to "N/A"
- - diagnostics - set to "N/A"
- - tracking URL - set to "N/A"
- - original tracking URL - set to "N/A"
- - resource usage report - all values are -1
-
-
- @param appId
- {@link ApplicationId} of the application that needs a report
- @return application report
- @throws YarnException
- @throws 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
- {@link #getApplicationReport(ApplicationId)}.
-
-
- @return a list of reports for all applications
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
-
-
-
- Get a report of the given ApplicationAttempt.
-
-
-
- In secure mode, YARN
verifies access to the application, queue
- etc. before accepting the request.
-
-
- @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]]>
-
-
-
-
-
-
-
-
- Get a report of all (ApplicationAttempts) of Application in the cluster.
-
-
- @param applicationId
- @return a list of reports for all application attempts for specified
- application
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
-
-
-
- Get a report of the given Container.
-
-
-
- In secure mode, YARN
verifies access to the application, queue
- etc. before accepting the request.
-
-
- @param containerId
- {@link ContainerId} of the container that needs a report
- @return container report
- @throws YarnException
- @throws ContainerNotFoundException if container not found
- @throws IOException]]>
-
-
-
-
-
-
-
-
- Get a report of all (Containers) of ApplicationAttempt in the cluster.
-
-
- @param applicationAttemptId
- @return a list of reports of all containers for specified application
- attempt
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
-
-
-
-
-
-
- {@code
- AMRMClient.createAMRMClientContainerRequest()
- }
- @return the newly create AMRMClient instance.]]>
-
-
-
-
-
-
-
-
-
- RegisterApplicationMasterResponse
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
-
-
- addContainerRequest are sent to the
- ResourceManager
. New containers assigned to the master are
- retrieved. Status of completed containers and node health updates are also
- retrieved. This also doubles up as a heartbeat to the ResourceManager and
- must be made periodically. The call may not always return any new
- allocations of containers. App should not make concurrent allocate
- requests. May cause request loss.
-
-
- Note : If the user has not removed container requests that have already
- been satisfied, then the re-register may end up sending the entire
- container requests to the RM (including matched requests). Which would mean
- the RM could end up giving it a lot of new allocated containers.
-
-
- @param progressIndicator Indicates progress made by the master
- @return the response of the allocate request
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- allocate
- @param req Resource request]]>
-
-
-
-
-
-
-
-
-
-
-
-
- allocate.
- Any previous pending resource change request of the same container will be
- removed.
-
- Application that calls this method is expected to maintain the
- Container
s that are returned from previous successful
- allocations or resource changes. By passing in the existing container and a
- target resource capability to this method, the application requests the
- ResourceManager to change the existing resource allocation to the target
- resource allocation.
-
- @param container The container returned from the last successful resource
- allocation or resource change
- @param capability The target resource capability of the container]]>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- ContainerRequests matching the given
- parameters. These ContainerRequests should have been added via
- addContainerRequest
earlier in the lifecycle. For performance,
- the AMRMClient may return its internal collection directly without creating
- a copy. Users should not perform mutable operations on the return value.
- Each collection in the list contains requests with identical
- Resource
size that fit in the given capability. In a
- collection, requests will be returned in the same order as they were added.
- @return Collection of request matching the parameters]]>
-
-
-
-
-
-
-
-
-
-
-
-
- AMRMClient. This cache must
- be shared with the {@link NMClient} used to manage containers for the
- AMRMClient
-
- If a NM token cache is not set, the {@link NMTokenCache#getSingleton()}
- singleton instance will be used.
-
- @param nmTokenCache the NM token cache to use.]]>
-
-
-
-
- AMRMClient. This cache must be
- shared with the {@link NMClient} used to manage containers for the
- AMRMClient
.
-
- If a NM token cache is not set, the {@link NMTokenCache#getSingleton()}
- singleton instance will be used.
-
- @return the NM token cache.]]>
-
-
-
-
-
-
- check to return true for each 1000 ms.
- See also {@link #waitFor(com.google.common.base.Supplier, int)}
- and {@link #waitFor(com.google.common.base.Supplier, int, int)}
- @param check]]>
-
-
-
-
-
-
-
- check to return true for each
- checkEveryMillis
ms.
- See also {@link #waitFor(com.google.common.base.Supplier, int, int)}
- @param check user defined checker
- @param checkEveryMillis interval to call check
]]>
-
-
-
-
-
-
-
-
- check to return true for each
- checkEveryMillis
ms. In the main loop, this method will log
- the message "waiting in main loop" for each logInterval
times
- iteration to confirm the thread is alive.
- @param check user defined checker
- @param checkEveryMillis interval to call check
- @param logInterval interval to log for each]]>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Start an allocated container.
-
- The ApplicationMaster
or other applications that use the
- client must provide the details of the allocated container, including the
- Id, the assigned node's Id and the token via {@link Container}. In
- addition, the AM needs to provide the {@link ContainerLaunchContext} as
- well.
-
- @param container the allocated container
- @param containerLaunchContext the context information needed by the
- NodeManager
to launch the
- container
- @return a map between the auxiliary service names and their outputs
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
-
-
- Increase the resource of a container.
-
- The ApplicationMaster
or other applications that use the
- client must provide the details of the container, including the Id and
- the target resource encapsulated in the updated container token via
- {@link Container}.
-
-
- @param container the container with updated token
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
-
-
-
- Stop an started container.
-
- @param containerId the Id of the started container
- @param nodeId the Id of the NodeManager
-
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
-
-
-
- Query the status of a container.
-
- @param containerId the Id of the started container
- @param nodeId the Id of the NodeManager
-
- @return the status of a container
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
- Set whether the containers that are started by this client, and are
- still running should be stopped when the client stops. By default, the
- feature should be enabled. However, containers will be stopped only
- when service is stopped. i.e. after {@link NMClient#stop()}.
-
- @param enabled whether the feature is enabled or not]]>
-
-
-
-
-
- NMClient. This cache must be
- shared with the {@link AMRMClient} that requested the containers managed
- by this NMClient
-
- If a NM token cache is not set, the {@link NMTokenCache#getSingleton()}
- singleton instance will be used.
-
- @param nmTokenCache the NM token cache to use.]]>
-
-
-
-
- NMClient. This cache must be
- shared with the {@link AMRMClient} that requested the containers managed
- by this NMClient
-
- If a NM token cache is not set, the {@link NMTokenCache#getSingleton()}
- singleton instance will be used.
-
- @return the NM token cache]]>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- By default Yarn client libraries {@link AMRMClient} and {@link NMClient} use
- {@link #getSingleton()} instance of the cache.
-
- -
- Using the singleton instance of the cache is appropriate when running a
- single ApplicationMaster in the same JVM.
-
- -
- When using the singleton, users don't need to do anything special,
- {@link AMRMClient} and {@link NMClient} are already set up to use the
- default singleton {@link NMTokenCache}
-
-
- If running multiple Application Masters in the same JVM, a different cache
- instance should be used for each Application Master.
-
- -
- If using the {@link AMRMClient} and the {@link NMClient}, setting up
- and using an instance cache is as follows:
-
- NMTokenCache nmTokenCache = new NMTokenCache();
- AMRMClient rmClient = AMRMClient.createAMRMClient();
- NMClient nmClient = NMClient.createNMClient();
- nmClient.setNMTokenCache(nmTokenCache);
- ...
-
-
- -
- If using the {@link AMRMClientAsync} and the {@link NMClientAsync},
- setting up and using an instance cache is as follows:
-
- NMTokenCache nmTokenCache = new NMTokenCache();
- AMRMClient rmClient = AMRMClient.createAMRMClient();
- NMClient nmClient = NMClient.createNMClient();
- nmClient.setNMTokenCache(nmTokenCache);
- AMRMClientAsync rmClientAsync = new AMRMClientAsync(rmClient, 1000, [AMRM_CALLBACK]);
- NMClientAsync nmClientAsync = new NMClientAsync("nmClient", nmClient, [NM_CALLBACK]);
- ...
-
-
- -
- If using {@link ApplicationMasterProtocol} and
- {@link ContainerManagementProtocol} directly, setting up and using an
- instance cache is as follows:
-
- NMTokenCache nmTokenCache = new NMTokenCache();
- ...
- ApplicationMasterProtocol amPro = ClientRMProxy.createRMProxy(conf, ApplicationMasterProtocol.class);
- ...
- AllocateRequest allocateRequest = ...
- ...
- AllocateResponse allocateResponse = rmClient.allocate(allocateRequest);
- for (NMToken token : allocateResponse.getNMTokens()) {
- nmTokenCache.setToken(token.getNodeId().toString(), token.getToken());
- }
- ...
- ContainerManagementProtocolProxy nmPro = ContainerManagementProtocolProxy(conf, nmTokenCache);
- ...
- nmPro.startContainer(container, containerContext);
- ...
-
-
-
- It is also possible to mix the usage of a client ({@code AMRMClient} or
- {@code NMClient}, or the async versions of them) with a protocol proxy
- ({@code ContainerManagementProtocolProxy} or
- {@code ApplicationMasterProtocol}).]]>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- The method to claim a resource with the SharedCacheManager.
- The client uses a checksum to identify the resource and an
- {@link ApplicationId} to identify which application will be using the
- resource.
-
-
-
- The SharedCacheManager
responds with whether or not the
- resource exists in the cache. If the resource exists, a Path
- to the resource in the shared cache is returned. If the resource does not
- exist, null is returned instead.
-
-
- @param applicationId ApplicationId of the application using the resource
- @param resourceKey the key (i.e. checksum) that identifies the resource
- @return Path to the resource, or null if it does not exist]]>
-
-
-
-
-
-
-
-
- The method to release a resource with the SharedCacheManager.
- This method is called once an application is no longer using a claimed
- resource in the shared cache. The client uses a checksum to identify the
- resource and an {@link ApplicationId} to identify which application is
- releasing the resource.
-
-
-
- Note: This method is an optimization and the client is not required to call
- it for correctness.
-
-
- @param applicationId ApplicationId of the application releasing the
- resource
- @param resourceKey the key (i.e. checksum) that identifies the resource]]>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 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.
-
-
- @return {@link YarnClientApplication} built for a new application
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
-
-
-
- Submit a new application to YARN.
It is a blocking call - it
- will not return {@link ApplicationId} until the submitted application is
- submitted successfully and accepted by the ResourceManager.
-
-
-
- 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}.
-
-
- 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}
-
- @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()]]>
-
-
-
-
-
-
-
-
- Fail an application attempt identified by given ID.
-
-
- @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()]]>
-
-
-
-
-
-
-
-
- Kill an application identified by given ID.
-
-
- @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()]]>
-
-
-
-
-
-
-
-
-
- Kill an application identified by given ID.
-
- @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]]>
-
-
-
-
-
-
-
-
- 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:
-
- - host - set to "N/A"
- - RPC port - set to -1
- - client token - set to "N/A"
- - diagnostics - set to "N/A"
- - tracking URL - set to "N/A"
- - original tracking URL - set to "N/A"
- - resource usage report - all values are -1
-
-
- @param appId
- {@link ApplicationId} of the application that needs a report
- @return application report
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
-
-
-
- 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.
-
- The AMRM token will be returned only if all the following conditions are
- met:
-
- - the requester is the owner of the ApplicationMaster
- - the application master is an unmanaged ApplicationMaster
- - the application master is in ACCEPTED state
-
- 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]]>
-
-
-
-
-
-
-
- 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
- {@link #getApplicationReport(ApplicationId)}.
-
-
- @return a list of reports of all running applications
- @throws YarnException
- @throws 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
- {@link #getApplicationReport(ApplicationId)}.
-
-
- @param applicationTypes set of application types you are interested in
- @return a list of reports of applications
- @throws YarnException
- @throws 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
- {@link #getApplicationReport(ApplicationId)}.
-
-
- @param applicationStates set of application states you are interested in
- @return a list of reports of applications
- @throws YarnException
- @throws 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
- {@link #getApplicationReport(ApplicationId)}.
-
-
- @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]]>
-
-
-
-
-
-
-
-
-
-
-
- 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.
-
-
-
- If the user does not have VIEW_APP
access for an application
- then the corresponding report will be filtered as described in
- {@link #getApplicationReport(ApplicationId)}.
-
-
- @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]]>
-
-
-
-
-
-
-
- Get metrics ({@link YarnClusterMetrics}) about the cluster.
-
-
- @return cluster metrics
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
-
-
-
- Get a report of nodes ({@link NodeReport}) in the cluster.
-
-
- @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]]>
-
-
-
-
-
-
-
-
- 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]]>
-
-
-
-
-
-
-
-
- Get information ({@link QueueInfo}) about a given queue.
-
-
- @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]]>
-
-
-
-
-
-
-
- Get information ({@link QueueInfo}) about all queues, recursively if there
- is a hierarchy
-
-
- @return a list of queue-information for all queues
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
-
-
- Get information ({@link QueueInfo}) about top level queues.
-
-
- @return a list of queue-information for all the top-level queues
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
-
-
-
- Get information ({@link QueueInfo}) about all the immediate children queues
- of the given queue
-
-
- @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]]>
-
-
-
-
-
-
-
- Get information about acls for current user on all the
- existing queues.
-
-
- @return a list of queue acls ({@link QueueUserACLInfo}) for
- current user
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
-
-
-
- Get a report of the given ApplicationAttempt.
-
-
-
- In secure mode, YARN
verifies access to the application, queue
- etc. before accepting the request.
-
-
- @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]]>
-
-
-
-
-
-
-
-
- Get a report of all (ApplicationAttempts) of Application in the cluster.
-
-
- @param applicationId application id of the app
- @return a list of reports for all application attempts for specified
- application.
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
-
-
-
- Get a report of the given Container.
-
-
-
- In secure mode, YARN
verifies access to the application, queue
- etc. before accepting the request.
-
-
- @param containerId
- {@link ContainerId} of the container that needs a report
- @return container report
- @throws YarnException
- @throws ContainerNotFoundException if container not found.
- @throws IOException]]>
-
-
-
-
-
-
-
-
- Get a report of all (Containers) of ApplicationAttempt in the cluster.
-
-
- @param applicationAttemptId application attempt id
- @return a list of reports of all containers for specified application
- attempts
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
-
-
-
-
- Attempts to move the given application to the given queue.
-
-
- @param appId
- Application to move.
- @param queue
- Queue to place it in to.
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
-
-
- Obtain a {@link GetNewReservationResponse} for a new reservation,
- which contains the {@link ReservationId} object.
-
-
- @return The {@link GetNewReservationResponse} containing a new
- {@link ReservationId} object.
- @throws YarnException if reservation cannot be created.
- @throws IOException if reservation cannot be created.]]>
-
-
-
-
-
-
-
-
- The interface used by clients to submit a new reservation to the
- {@code ResourceManager}.
-
-
-
- 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.
-
-
-
- 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.
-
-
-
- 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}
-
-
- @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]]>
-
-
-
-
-
-
-
-
- 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.
-
-
-
- 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.
-
-
- @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]]>
-
-
-
-
-
-
-
-
- The interface used by clients to remove an existing Reservation.
-
-
- @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]]>
-
-
-
-
-
-
-
-
- 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).
-
-
- @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]]>
-
-
-
-
-
-
-
- The interface used by client to get node to labels mappings in existing cluster
-
-
- @return node to labels mappings
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
-
-
- The interface used by client to get labels to nodes mapping
- in existing cluster
-
-
- @return node to labels mappings
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
-
-
-
- The interface used by client to get labels to nodes mapping
- for specified labels in existing cluster
-
-
- @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]]>
-
-
-
-
-
-
-
- The interface used by client to get node labels in the cluster
-
-
- @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}]]>
-
-
-
-
-
-
-
-
-
- The interface used by client to set priority of an application
-
- @param applicationId
- @param priority
- @return updated priority of an application.
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
-
-
-
-
- Signal a container identified by given ID.
-
-
- @param containerId
- {@link ContainerId} of the container that needs to be signaled
- @param command the signal container command
- @throws YarnException
- @throws IOException]]>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Create a new instance of AMRMClientAsync.
-
- @param intervalMs heartbeat interval in milliseconds between AM and RM
- @param callbackHandler callback handler that processes responses from
- the ResourceManager
]]>
-
-
-
-
-
-
-
- Create a new instance of AMRMClientAsync.
-
- @param client the AMRMClient instance
- @param intervalMs heartbeat interval in milliseconds between AM and RM
- @param callbackHandler callback handler that processes responses from
- the ResourceManager
]]>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
---------------------------------------------------------------------
To unsubscribe, e-mail: common-commits-unsubscribe@hadoop.apache.org
For additional commands, e-mail: common-commits-help@hadoop.apache.org