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


Spectra S3 Bucket, Object, and Job Operations : Job Operations : Allocate Job Chunk
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.
Notes:
 
§
For most purposes, it is better to use Get Job Chunks Ready for Processing instead of this request.
§
Aggregating PUT jobs (see aggregating) are always entirely pre-allocated. Submitting this request will return a 404 error.
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
      Id="{string}"
      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.
Id
The UUID for the object.
InCache
Indicates if the object is currently in cache on the BlackPearl Converged Storage System. 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
      Id="c0caabee-9e86-474a-8c83-e2b425b8ad1d" InCache="FALSE"
      Length="1024" Name="test" Offset="0" Version=1"/>
</Objects>