org.openstack4j.api.storage

Interface ObjectStorageContainerService

All Superinterfaces:

RestService

All Known Implementing Classes:

ObjectStorageContainerServiceImpl

public interface ObjectStorageContainerService
extends RestService

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

Author:

Jeremy Unruh

Method Summary

Modifier and Type	Method and Description
ActionResponse	create(String name) Creates a new container with the specified name
ActionResponse	create(String name, CreateUpdateContainerOptions options) Creates a new container with the specified name with options
String	createPath(String containerName, String path) Creates a pseudo path aka directory for the specified containerName
ActionResponse	delete(String name) Deletes an empty container with the specified name
boolean	deleteMetadata(String name, Map<String,String> metadata) Deletes metadata items from the specified container name
Map<String,String>	getMetadata(String name) Gets the Metadata for a given container
List<? extends SwiftContainer>	list() Listing of all containers associated with the Account (max result size is 10,000);
List<? extends SwiftContainer>	list(ContainerListOptions options) Listing of all containers with the associated options used in the query
ActionResponse	update(String name, CreateUpdateContainerOptions options) Updates a container with the specified name with options
boolean	updateMetadata(String name, Map<String,String> metadata) Creates or Updates metadata items for the specified container name

Method Detail

list

List<? extends SwiftContainer> list()

Listing of all containers associated with the Account (max result size is 10,000);

Returns:

List of containers ordered by name

list

List<? extends SwiftContainer> list(ContainerListOptions options)

Listing of all containers with the associated options used in the query

Parameters:

options - the query based options

Returns:

List of containers ordered by name

create

ActionResponse create(String name)

Creates a new container with the specified name

Parameters:

name - the name of the new container

Returns:

the action response

createPath

String createPath(String containerName,
                  String path)

Creates a pseudo path aka directory for the specified containerName

Parameters:

containerName - the name of the container

path - the path to create

Returns:

the ETAG checksum of the new path

create

ActionResponse create(String name,
                      CreateUpdateContainerOptions options)

Creates a new container with the specified name with options

Parameters:

name - the name of the new container

options - the options to use when creating a container

Returns:

the action response

update

ActionResponse update(String name,
                      CreateUpdateContainerOptions options)

Updates a container with the specified name with options

Parameters:

name - the name of the container to update

options - the options to use when updating a container

the - action response

delete

ActionResponse delete(String name)

Deletes an empty container with the specified name

Parameters:

name - the name of the container to delete

Returns:

the action response (true if successfully deleted)

getMetadata

Map<String,String> getMetadata(String name)

Gets the Metadata for a given container

Parameters:

name - the container name

Returns:

Map of key to value metadata

updateMetadata

boolean updateMetadata(String name,
                       Map<String,String> metadata)

Creates or Updates metadata items for the specified container name

Parameters:

name - the name of the container

metadata - the metadata to create/update for this container

Returns:

true if the create/update was successful, false if not

deleteMetadata

boolean deleteMetadata(String name,
                       Map<String,String> metadata)

Deletes metadata items from the specified container name

Parameters:

name - the name of the container

metadata - the metadata items to remove from the container's metadata

Returns:

true if the removal of items was successful, false if not