Documentation
¶
Overview ¶
Package swift provides an absraction of the Openstack Swift storage technology. An Openstack Swift Container is represented by a Stow Container, and an Openstack Swift Object is represented by a Stow Item. Note that directories may exist within a Swift Container.
Usage and Credentials ¶
Four pieces of information are needed: the user's name and password which will be used to access the Swift endpoint, the tenant name used to identify the storage endpoint, and the authentication URL.
stow.Dial requires both a string value of the particular Stow Location Kind ("swift") and a stow.Config instance. The stow.Config instance requires two entries with the specific key value attributes:
- a key of swift.ConfigUsername with a value of the user account name - a key of swift.ConfigKey with a value of the user account password - a key of swift.ConfigTenantName with a value of the Swift endpoint's tenant name - a key of swift.ConfigTenantAuthURL with a value of the Swift endpoint's authentication URL
Location ¶
Methods of swift.location allow the retrieval of a Swift Container (Container or Containers). A stow.Item representation of a Swift Object can also be retrieved based on the Object's URL (ItemByURL).
Additional swift.location methods provide capabilities to create and remove Swift Containers (CreateContainer or RemoveContainer).
Container ¶
Methods of stow.container allow the retrieval of a Swift Container's:
- name(ID or Name) - item or complete list of items (Item or Items, respectively)
Additional methods of swift.container allow Stow to:
- remove a stow.Item (RemoveItem) - update or create a stow.Item (Put)
Item ¶
Methods of swift.Item allow the retrieval of a Swift Object's: - name (ID or name) - URL - size in bytes - Object specific metadata (information stored within the service) - last modified date - Etag - content
Index ¶
Constants ¶
const ( ConfigUsername = "username" ConfigKey = "key" ConfigTenantName = "tenant_name" ConfigTenantAuthURL = "tenant_auth_url" ConfigDomain = "domain" ConfigRegion = "region" ConfigTenantId = "tenant_id" ConfigTenantDomain = "tenant_domain" ConfigTrustId = "trust_id" ConfigStorageURL = "storage_url" ConfigAuthToken = "auth_token" )
Config key constants.
const Kind = "swift"
Kind is the kind of Location this package provides.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
This section is empty.
Source Files