For details on how to use this API, see Using OpenStack Object Store
The Object Store high-level interface is exposed as the object_store object on Connection objects.
Set metadata for this account.
Parameters: | metadata (kwargs) – Key/value pairs to be set as metadata on the container. Custom metadata can be set. Custom metadata are keys and values defined by the user. |
---|
Delete metadata for this account.
Parameters: | keys (list) – The keys of metadata to be deleted. |
---|
Obtain Container objects for this account.
Parameters: | query (kwargs) – Optional query parameters to be sent to limit the resources being returned. |
---|---|
Return type: | A generator of Container objects. |
Create a new container from attributes
Parameters: | attrs (dict) – Keyword arguments which will be used to create a Container, comprised of the properties on the Container class. |
---|---|
Returns: | The results of container creation |
Return type: | Container |
Delete a container
Parameters: |
|
---|---|
Returns: | None |
Get metadata for a container
Parameters: | container – The value can be the name of a container or a Container instance. |
---|---|
Returns: | One Container |
Raises: | ResourceNotFound when no resource can be found. |
Set metadata for a container.
Parameters: |
|
---|
Delete metadata for a container.
Parameters: |
|
---|
Return a generator that yields the Container’s objects.
Parameters: |
|
---|---|
Return type: | A generator of Object objects. |
Get the data associated with an object
Parameters: | |
---|---|
Returns: | The contents of the object. Use the get_object_metadata() method if you want an object resource. |
Raises: | ResourceNotFound when no resource can be found. |
Download the data contained inside an object to disk.
Parameters: | |
---|---|
Raises: | ResourceNotFound when no resource can be found. |
Upload a new object from attributes
Parameters: | attrs (dict) – Keyword arguments which will be used to create a Object, comprised of the properties on the Object class. Required: A container argument must be specified, which is either the ID of a container or a Container instance. |
---|---|
Returns: | The results of object creation |
Return type: | Container |
Copy an object.
Delete an object
Parameters: |
|
---|---|
Returns: | None |
Get metadata for an object.
Parameters: | |
---|---|
Returns: | One Object |
Raises: | ResourceNotFound when no resource can be found. |
Set metadata for an object.
Note: This method will do an extra HEAD call.
Parameters: |
|
---|
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.