accounts

Documentation

Overview

Package accounts contains functionality for working with Object Storage account resources. An account is the top-level resource the object storage hierarchy: containers belong to accounts, objects belong to containers.

Another way of thinking of an account is like a namespace for all your resources. It is synonymous with a project or tenant in other OpenStack services.

Index

• type GetOpts
  • func (opts GetOpts) ToAccountGetMap() (map[string]string, error)
• type GetOptsBuilder
• type GetResult
  • func Get(c *gophercloud.ServiceClient, opts GetOptsBuilder) GetResult
  • func (gr GetResult) ExtractMetadata() (map[string]string, error)
• type UpdateOpts
  • func (opts UpdateOpts) ToAccountUpdateMap() (map[string]string, error)
• type UpdateOptsBuilder
• type UpdateResult
  • func Update(c *gophercloud.ServiceClient, opts UpdateOptsBuilder) UpdateResult

Types

type GetOpts

type GetOpts struct {
	Newest bool `h:"X-Newest"`
}

GetOpts is a structure that contains parameters for getting an account's metadata.

func (GetOpts) ToAccountGetMap

func (opts GetOpts) ToAccountGetMap() (map[string]string, error)

ToAccountGetMap formats a GetOpts into a map[string]string of headers.

type GetOptsBuilder

type GetOptsBuilder interface {
	ToAccountGetMap() (map[string]string, error)
}

GetOptsBuilder allows extensions to add additional headers to the Get request.

type GetResult

type GetResult struct {
	gophercloud.HeaderResult
}

GetResult is returned from a call to the Get function.

func Get

func Get(c *gophercloud.ServiceClient, opts GetOptsBuilder) GetResult

Get is a function that retrieves an account's metadata. To extract just the custom metadata, call the ExtractMetadata method on the GetResult. To extract all the headers that are returned (including the metadata), call the ExtractHeader method on the GetResult.

func (GetResult) ExtractMetadata

func (gr GetResult) ExtractMetadata() (map[string]string, error)

ExtractMetadata is a function that takes a GetResult (of type *http.Response) and returns the custom metatdata associated with the account.

type UpdateOpts

type UpdateOpts struct {
	Metadata          map[string]string
	ContentType       string `h:"Content-Type"`
	DetectContentType bool   `h:"X-Detect-Content-Type"`
	TempURLKey        string `h:"X-Account-Meta-Temp-URL-Key"`
	TempURLKey2       string `h:"X-Account-Meta-Temp-URL-Key-2"`
}

UpdateOpts is a structure that contains parameters for updating, creating, or deleting an account's metadata.

func (UpdateOpts) ToAccountUpdateMap

func (opts UpdateOpts) ToAccountUpdateMap() (map[string]string, error)

ToAccountUpdateMap formats an UpdateOpts into a map[string]string of headers.

type UpdateOptsBuilder

type UpdateOptsBuilder interface {
	ToAccountUpdateMap() (map[string]string, error)
}

UpdateOptsBuilder allows extensions to add additional headers to the Update request.

type UpdateResult

type UpdateResult struct {
	gophercloud.HeaderResult
}

UpdateResult is returned from a call to the Update function.

func Update

func Update(c *gophercloud.ServiceClient, opts UpdateOptsBuilder) UpdateResult

Update is a function that creates, updates, or deletes an account's metadata. To extract the headers returned, call the Extract method on the UpdateResult.