Package org.jclouds.openstack.swift.v1.features

Interface BulkApi

@Beta
@Consumes("application/json")
public interface BulkApi

Provides access to the OpenStack Object Storage (Swift) Bulk API features.

This API is new to jclouds and hence is in Beta. That means we need people to use it and give us feedback. Based on that feedback, minor changes to the interfaces may happen. This code will replace org.jclouds.openstack.swift.SwiftClient in jclouds 2.0 and it is recommended you adopt it sooner than later.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	BulkApi.UrlEncodeAndJoinOnNewline

Method Summary

Modifier and Type	Method	Description
BulkDeleteResponse	bulkDelete(Iterable<String> paths)	Deletes multiple objects or containers, if present.
ExtractArchiveResponse	extractArchive(String path, Payload payload, String format)	Extracts a tar archive at the path specified as path.

Method Detail

extractArchive

@Named("bulk:extractArchive")
@PUT
@Path("/{path}")
ExtractArchiveResponse extractArchive(@PathParam("path")
                                      String path,
                                      Payload payload,
                                      @QueryParam("extract-archive")
                                      String format)

Extracts a tar archive at the path specified as path.

Parameters:

path - the path to extract under.

payload - the payload archive.

format - one of tar, tar.gz, or tar.bz2

Returns:

BulkDeleteResponse.getErrors() are empty on success.

bulkDelete

@Named("bulk:delete")
@DELETE
BulkDeleteResponse bulkDelete(Iterable<String> paths)

Deletes multiple objects or containers, if present.

Parameters:

paths - format of container, for an empty container, or container/object for an object.

Returns:

BulkDeleteResponse.getErrors() are empty on success.