Spectra Logic

1-800-833-1132 : 1-303-449-6400

Allocate Job Chunk

Description

Allocate a specific job chunk that is part of a PUT job before beginning the PUT operation. This avoids the HTTP 307 retries on the object PUTs and increases performance.

Note:

For most purposes, it is better to use Get Job Chunks Ready for Processing instead of this request.

Requests

Syntax

PUT http[s]://{datapathDNSname}/_rest_/job_chunk/{job chunk id}/?operation=ALLOCATE

To Determine the UUID for the job chunk, see Create Bulk Put.

Request Parameters

Parameter	Description	Required
operation	The operation to perform. For this request, the operation is allocate. Value: ALLOCATE	yes

Responses

Response Elements

<Objects
   ChunkId="{string}"
   ChunkNumber="{32-bit integer}"
   NodeId="{string}">
   <Object
      InCache="TRUE|FALSE"
      Length="{64-bit integer}"
      Name="{string}"
      Offset="{64-bit integer}"
      Version="{64-bit integer}"/>
   ...
</Objects>

where the response elements are defined as follows:

Parameter	Description
Objects	The container for the response.
ChunkID	The UUID for the job chunk.
ChunkNumber	The position of the chunk within the job.
NodeId	The UUID for the node.
Object	The container for object information.
InCache	Indicates if the object is currently in cache on the BlackPearl Deep Storage Gateway. Values: TRUE, FALSE
Length	The length in bytes of the object or part of the object.
Name	The name of the object.
Offset	The offset in bytes from the start of the object.
Version	The version number of the object.

Example

Sample Request

This request allocates the job chunks for the job with the UUID 38ada8a6-0116-42ac-9b58-a95cc89ddec9.

PUT http://blackpearl-hostname/_rest_/job_chunk/38ada8a6-0116-42ac-9b58-a95cc89ddec9

Sample Response

HTTP/1.1 200 OK
<Objects ChunkId="5721e057-036e-4eda-8b9e-f842cc667352"
   ChunkNumber="1"
   NodeId="86aa6d66-2438-49cd-9dba-0b17c109daab">
   <Object InCache="FALSE" Length="1024" Name="test" Offset="0"    Version="1"/>
</Objects>