Delete Requests

Article
03/28/2018

Deletes a batch of SOA requests that you previously sent.

Request

You can specify the Delete Requests request as follows.

Method	Request URI
POST (before HPC Pack 2016)	https://head_node_name:port/WindowsHpc/HPC_cluster_name/session/session_identifier/batch/batch_name/Purge
POST (HPC Pack 2016)	https://head_node_name:port/WindowsHpc/session/session_identifier/batch/batch_name/Purge

For sessions that are managed by the Azure HPC Scheduler, the head node name should have a format of Azure_service_name.cloudapp.net.

To get the name to use for the HPC cluster, use the Get Clusters operation.

URI Parameters

You can specify the following additional parameters on the request URI.

Parameter	Description
api-version	Required if the request does not contain the api-version header. Specifies the version of the operation to use for this request. To specify Microsoft HPC Pack 2008 R2 with Service Pack 3 (SP3), use a value of 2011-11-01. The minimum version that supports this operation is Microsoft HPC Pack 2008 R2 with SP3. The value of this URI parameter is ignored if the request also contains the api-version header.

api-version

Required if the request does not contain the api-version header. Specifies the version of the operation to use for this request. To specify Microsoft HPC Pack 2008 R2 with Service Pack 3 (SP3), use a value of 2011-11-01. The minimum version that supports this operation is Microsoft HPC Pack 2008 R2 with SP3.

The value of this URI parameter is ignored if the request also contains the api-version header.

Request Headers

The following table describes required and optional request headers.

Request Header	Description
api-version	Required if the request does not include the api-version URI parameter. Specifies the version of the operation to use for this request. To specify Microsoft HPC Pack 2008 R2 with SP3, use a value of 2011-11-01. The minimum version that supports this operation is Microsoft HPC Pack 2008 R2 with SP3. The value specified in this header overrides the value specified in the api-version URI parameter if both are specified.
CONTENT-TYPE	Indicates the type of content that the request contains.
Content-Length	Required. Indicates the length of the request body. Specify 0 for this request.
Accept	Optional. Specifies the type of content accepted in the response. Specify application/json to get a response body that is an object represented as text in JavaScript Object Notation (JSON), or specify application/xml to get a response body that is formatted as XML. The default value is application/xml.

Request Body

None.

Response

The response includes an HTTP status code and a set of response headers.

Status Code

A successful operation returns status code 200 (OK).

If the request includes neither the api-version URI parameter nor the api-version header, the operation returns status code 400 (Bad Request).

For more information about status codes, see HttpStatusCode.

The error response will be contained in a descriptive XML response (Note: Values will vary based on the error):

<HpcWebServiceFault xmlns="https://schemas.microsoft.com/HPCS2008R2/common" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Code>267386880</Code>
  <Message>Error message text.</Message>
  <Values i:nil="true" xmlns:a="http://schemas.datacontract.org/2004/07/System.Collections.Generic"/>
</HpcWebServiceFault>

Response Headers

The response for this operation includes the following standard HTTP headers:

Content-Length
Date
Pack

All standard headers conform to the HTTP/1.1 protocol specification.

Response Body

None.

Remarks

This operation is supported only for sessions that are managed by the Azure HPC Scheduler.

Requirements

Product

HPC Pack 2008 R2 with at least SP3, or a later version of HPC Pack.