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 - Containers 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