members

Documentation

Overview

Package members enables management and retrieval of image members.

Members are projects other than the image owner who have access to the image.

Example to List Members of an Image

imageID := "2b6cacd4-cfd6-4b95-8302-4c04ccf0be3f"

allPages, err := members.List(imageID).AllPages()
if err != nil {
	panic(err)
}

allMembers, err := members.ExtractMembers(allPages)
if err != nil {
	panic(err)
}

for _, member := range allMembers {
	fmt.Printf("%+v\n", member)
}

Example to Add a Member to an Image

imageID := "2b6cacd4-cfd6-4b95-8302-4c04ccf0be3f"
projectID := "fc404778935a4cebaddcb4788fb3ff2c"

member, err := members.Create(imageClient, imageID, projectID).Extract()
if err != nil {
	panic(err)
}

Example to Update the Status of a Member

imageID := "2b6cacd4-cfd6-4b95-8302-4c04ccf0be3f"
projectID := "fc404778935a4cebaddcb4788fb3ff2c"

updateOpts := members.UpdateOpts{
	Status: "accepted",
}

member, err := members.Update(imageClient, imageID, projectID, updateOpts).Extract()
if err != nil {
	panic(err)
}

Example to Delete a Member from an Image

imageID := "2b6cacd4-cfd6-4b95-8302-4c04ccf0be3f"
projectID := "fc404778935a4cebaddcb4788fb3ff2c"

err := members.Delete(imageClient, imageID, projectID).ExtractErr()
if err != nil {
	panic(err)
}

Index

• func List(client *gophercloud.ServiceClient, id string) pagination.Pager
• type CreateResult
  • func Create(client *gophercloud.ServiceClient, id string, member string) (r CreateResult)
  • func (r CreateResult) Extract() (*Member, error)
• type DeleteResult
  • func Delete(client *gophercloud.ServiceClient, imageID string, memberID string) (r DeleteResult)
• type DetailsResult
  • func Get(client *gophercloud.ServiceClient, imageID string, memberID string) (r DetailsResult)
  • func (r DetailsResult) Extract() (*Member, error)
• type Member
  • func ExtractMembers(r pagination.Page) ([]Member, error)
• type MemberPage
  • func (r MemberPage) IsEmpty() (bool, error)
• type UpdateOpts
  • func (opts UpdateOpts) ToImageMemberUpdateMap() (map[string]interface{}, error)
• type UpdateOptsBuilder
• type UpdateResult
  • func Update(client *gophercloud.ServiceClient, imageID string, memberID string, ...) (r UpdateResult)
  • func (r UpdateResult) Extract() (*Member, error)

Functions

func List

func List(client *gophercloud.ServiceClient, id string) pagination.Pager

List members returns list of members for specifed image id.

Types

type CreateResult

type CreateResult struct {
	// contains filtered or unexported fields
}

CreateResult represents the result of a Create operation. Call its Extract method to interpret it as a Member.

func Create

func Create(client *gophercloud.ServiceClient, id string, member string) (r CreateResult)

Create member for specific image

Preconditions

• The specified images must exist.
• You can only add a new member to an image which 'visibility' attribute is private.
• You must be the owner of the specified image.

Synchronous Postconditions

With correct permissions, you can see the member status of the image as pending through API calls.

More details here: http://developer.openstack.org/api-ref-image-v2.html#createImageMember-v2

func (CreateResult) Extract

func (r CreateResult) Extract() (*Member, error)

Extract Member model from a request.

type DeleteResult

type DeleteResult struct {
	gophercloud.ErrResult
}

DeleteResult represents the result of a Delete operation. Call its ExtractErr method to determine if the request succeeded or failed.

func Delete

func Delete(client *gophercloud.ServiceClient, imageID string, memberID string) (r DeleteResult)

Delete membership for given image. Callee should be image owner.

type DetailsResult

type DetailsResult struct {
	// contains filtered or unexported fields
}

DetailsResult represents the result of a Get operation. Call its Extract method to interpret it as a Member.

func Get

func Get(client *gophercloud.ServiceClient, imageID string, memberID string) (r DetailsResult)

Get image member details.

func (DetailsResult) Extract

func (r DetailsResult) Extract() (*Member, error)

Extract Member model from a request.

type Member

type Member struct {
	CreatedAt time.Time `json:"created_at"`
	ImageID   string    `json:"image_id"`
	MemberID  string    `json:"member_id"`
	Schema    string    `json:"schema"`
	Status    string    `json:"status"`
	UpdatedAt time.Time `json:"updated_at"`
}

Member represents a member of an Image.

func ExtractMembers

func ExtractMembers(r pagination.Page) ([]Member, error)

ExtractMembers returns a slice of Members contained in a single page of results.

type MemberPage

type MemberPage struct {
	pagination.SinglePageBase
}

MemberPage is a single page of Members results.

func (MemberPage) IsEmpty

func (r MemberPage) IsEmpty() (bool, error)

IsEmpty determines whether or not a MemberPage contains any results.

type UpdateOpts

type UpdateOpts struct {
	Status string
}

UpdateOpts represents options to an Update request.

func (UpdateOpts) ToImageMemberUpdateMap

func (opts UpdateOpts) ToImageMemberUpdateMap() (map[string]interface{}, error)

ToMemberUpdateMap formats an UpdateOpts structure into a request body.

type UpdateOptsBuilder

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

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

type UpdateResult

type UpdateResult struct {
	// contains filtered or unexported fields
}

UpdateResult represents the result of an Update operation. Call its Extract method to interpret it as a Member.

func Update

func Update(client *gophercloud.ServiceClient, imageID string, memberID string, opts UpdateOptsBuilder) (r UpdateResult)

Update function updates member.

func (UpdateResult) Extract

func (r UpdateResult) Extract() (*Member, error)

Extract Member model from a request.