glance_store.multi_backend module¶

glance_store.multi_backend.add(conf, image_id, data, size, backend, context=None, verifier=None)¶

glance_store.multi_backend.add_with_multihash(conf, image_id, data, size, backend, hashing_algo, scheme=None, context=None, verifier=None)¶

glance_store.multi_backend.check_location_metadata(val, key='')¶

glance_store.multi_backend.create_multi_stores(conf=<oslo_config.cfg.ConfigOpts object>)¶

Registers all store modules and all schemes from the given config.

glance_store.multi_backend.delete(uri, backend, context=None)¶

Removes chunks of data from backend specified by uri.

glance_store.multi_backend.get(uri, backend, offset=0, chunk_size=None, context=None)¶

Yields chunks of data from backend specified by uri.

glance_store.multi_backend.get_known_schemes_for_multi_store()¶

Returns list of known schemes.

glance_store.multi_backend.get_size_from_uri_and_backend(uri, backend, context=None)¶

Retrieves image size from backend specified by uri.

glance_store.multi_backend.get_store_from_store_identifier(store_identifier)¶

Determine backing store from identifier.

Given a store identifier, return the appropriate store object for handling that scheme.

glance_store.multi_backend.register_store_opts(conf)¶

glance_store.multi_backend.set_acls_for_multi_store(location_uri, backend, public=False, read_tenants=[], write_tenants=None, context=None)¶

glance_store.multi_backend.store_add_to_backend(image_id, data, size, store, context=None, verifier=None)¶

A wrapper around a call to each stores add() method.

This gives glance a common place to check the output.

Parameters

• image_id – The image add to which data is added

• data – The data to be stored

• size – The length of the data in bytes

• store – The store to which the data is being added

• context – The request context

• verifier – An object used to verify signatures for images

• backend – Name of the backend to store the image

Returns

The url location of the file, the size amount of data, the checksum of the data the storage systems metadata dictionary for the location

glance_store.multi_backend.store_add_to_backend_with_multihash(image_id, data, size, hashing_algo, store, context=None, verifier=None)¶

A wrapper around a call to each store’s add() method that requires a hashing_algo identifier and returns a 5-tuple including the “multihash” computed using the specified hashing_algo. (This is an enhanced version of store_add_to_backend(), which is left as-is for backward compatibility.)

Parameters

• image_id – The image add to which data is added

• data – The data to be stored

• size – The length of the data in bytes

• store – The store to which the data is being added

• hashing_algo – A hashlib algorithm identifier (string)

• context – The request context

• verifier – An object used to verify signatures for images

Returns

The url location of the file, the size amount of data, the checksum of the data, the multihash of the data, the storage system’s metadata dictionary for the location

Raises

glance_store.exceptions.BackendException glance_store.exceptions.UnknownHashingAlgo

glance_store.multi_backend.verify_store()¶