gophercloud: github.com/rackspace/gophercloud/openstack/compute/v2/servers Index | Files

package servers

import "github.com/rackspace/gophercloud/openstack/compute/v2/servers"

Package servers provides information and interaction with the server API resource in the OpenStack Compute service.

A server is a virtual machine instance in the compute system. In order for one to be provisioned, a valid flavor and image are required.

Index

Package Files

doc.go requests.go results.go urls.go util.go

func ExtractAddresses Uses

func ExtractAddresses(page pagination.Page) (map[string][]Address, error)

ExtractAddresses interprets the results of a single page from a ListAddresses() call, producing a map of addresses.

func ExtractNetworkAddresses Uses

func ExtractNetworkAddresses(page pagination.Page) ([]Address, error)

ExtractNetworkAddresses interprets the results of a single page from a ListAddressesByNetwork() call, producing a slice of addresses.

func ExtractServers Uses

func ExtractServers(page pagination.Page) ([]Server, error)

ExtractServers interprets the results of a single page from a List() call, producing a slice of Server entities.

func IDFromName Uses

func IDFromName(client *gophercloud.ServiceClient, name string) (string, error)

IDFromName is a convienience function that returns a server's ID given its name.

func List Uses

func List(client *gophercloud.ServiceClient, opts ListOptsBuilder) pagination.Pager

List makes a request against the API to list servers accessible to you.

func ListAddresses Uses

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

ListAddresses makes a request against the API to list the servers IP addresses.

func ListAddressesByNetwork Uses

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

ListAddressesByNetwork makes a request against the API to list the servers IP addresses for the given network.

func WaitForStatus Uses

func WaitForStatus(c *gophercloud.ServiceClient, id, status string, secs int) error

WaitForStatus will continually poll a server until it successfully transitions to a specified status. It will do this for at most the number of seconds specified.

type ActionResult Uses

type ActionResult struct {
    gophercloud.ErrResult
}

ActionResult represents the result of server action operations, like reboot

func ChangeAdminPassword Uses

func ChangeAdminPassword(client *gophercloud.ServiceClient, id, newPassword string) ActionResult

ChangeAdminPassword alters the administrator or root password for a specified server.

func ConfirmResize Uses

func ConfirmResize(client *gophercloud.ServiceClient, id string) ActionResult

ConfirmResize confirms a previous resize operation on a server. See Resize() for more details.

func ForceDelete Uses

func ForceDelete(client *gophercloud.ServiceClient, id string) ActionResult

func Reboot Uses

func Reboot(client *gophercloud.ServiceClient, id string, how RebootMethod) ActionResult

Reboot requests that a given server reboot. Two methods exist for rebooting a server:

HardReboot (aka PowerCycle) restarts the server instance by physically cutting power to the machine, or if a VM, terminating it at the hypervisor level. It's done. Caput. Full stop. Then, after a brief while, power is restored or the VM instance restarted.

SoftReboot (aka OSReboot) simply tells the OS to restart under its own procedures. E.g., in Linux, asking it to enter runlevel 6, or executing "sudo shutdown -r now", or by asking Windows to restart the machine.

func Resize Uses

func Resize(client *gophercloud.ServiceClient, id string, opts ResizeOptsBuilder) ActionResult

Resize instructs the provider to change the flavor of the server. Note that this implies rebuilding it. Unfortunately, one cannot pass rebuild parameters to the resize function. When the resize completes, the server will be in RESIZE_VERIFY state. While in this state, you can explore the use of the new server's configuration. If you like it, call ConfirmResize() to commit the resize permanently. Otherwise, call RevertResize() to restore the old configuration.

func RevertResize Uses

func RevertResize(client *gophercloud.ServiceClient, id string) ActionResult

RevertResize cancels a previous resize operation on a server. See Resize() for more details.

type Address Uses

type Address struct {
    Version int    `mapstructure:"version"`
    Address string `mapstructure:"addr"`
}

Address represents an IP address.

type AddressPage Uses

type AddressPage struct {
    pagination.SinglePageBase
}

AddressPage abstracts the raw results of making a ListAddresses() request against the API. As OpenStack extensions may freely alter the response bodies of structures returned to the client, you may only safely access the data provided through the ExtractAddresses call.

func (AddressPage) IsEmpty Uses

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

IsEmpty returns true if an AddressPage contains no networks.

type CreateImageOpts Uses

type CreateImageOpts struct {
    // Name [required] of the image/snapshot
    Name string
    // Metadata [optional] contains key-value pairs (up to 255 bytes each) to attach to the created image.
    Metadata map[string]string
}

func (CreateImageOpts) ToServerCreateImageMap Uses

func (opts CreateImageOpts) ToServerCreateImageMap() (map[string]interface{}, error)

ToServerCreateImageMap formats a CreateImageOpts structure into a request body.

type CreateImageOptsBuilder Uses

type CreateImageOptsBuilder interface {
    ToServerCreateImageMap() (map[string]interface{}, error)
}

type CreateImageResult Uses

type CreateImageResult struct {
    gophercloud.Result
}

CreateImageResult represents the result of an image creation operation

func CreateImage Uses

func CreateImage(client *gophercloud.ServiceClient, serverId string, opts CreateImageOptsBuilder) CreateImageResult

CreateImage makes a request against the nova API to schedule an image to be created of the server

func (CreateImageResult) ExtractImageID Uses

func (res CreateImageResult) ExtractImageID() (string, error)

ExtractImageID gets the ID of the newly created server image from the header

type CreateMetadatumResult Uses

type CreateMetadatumResult struct {
    MetadatumResult
}

CreateMetadatumResult temporarily contains the response from a metadatum Create call.

func CreateMetadatum Uses

func CreateMetadatum(client *gophercloud.ServiceClient, id string, opts MetadatumOptsBuilder) CreateMetadatumResult

CreateMetadatum will create or update the key-value pair with the given key for the given server ID.

type CreateOpts Uses

type CreateOpts struct {
    // Name [required] is the name to assign to the newly launched server.
    Name string

    // ImageRef [optional; required if ImageName is not provided] is the ID or full
    // URL to the image that contains the server's OS and initial state.
    // Also optional if using the boot-from-volume extension.
    ImageRef string

    // ImageName [optional; required if ImageRef is not provided] is the name of the
    // image that contains the server's OS and initial state.
    // Also optional if using the boot-from-volume extension.
    ImageName string

    // FlavorRef [optional; required if FlavorName is not provided] is the ID or
    // full URL to the flavor that describes the server's specs.
    FlavorRef string

    // FlavorName [optional; required if FlavorRef is not provided] is the name of
    // the flavor that describes the server's specs.
    FlavorName string

    // SecurityGroups [optional] lists the names of the security groups to which this server should belong.
    SecurityGroups []string

    // UserData [optional] contains configuration information or scripts to use upon launch.
    // Create will base64-encode it for you.
    UserData []byte

    // AvailabilityZone [optional] in which to launch the server.
    AvailabilityZone string

    // Networks [optional] dictates how this server will be attached to available networks.
    // By default, the server will be attached to all isolated networks for the tenant.
    Networks []Network

    // Metadata [optional] contains key-value pairs (up to 255 bytes each) to attach to the server.
    Metadata map[string]string

    // Personality [optional] includes files to inject into the server at launch.
    // Create will base64-encode file contents for you.
    Personality Personality

    // ConfigDrive [optional] enables metadata injection through a configuration drive.
    ConfigDrive bool

    // AdminPass [optional] sets the root user password. If not set, a randomly-generated
    // password will be created and returned in the response.
    AdminPass string

    // AccessIPv4 [optional] specifies an IPv4 address for the instance.
    AccessIPv4 string

    // AccessIPv6 [optional] specifies an IPv6 address for the instance.
    AccessIPv6 string
}

CreateOpts specifies server creation parameters.

func (CreateOpts) ToServerCreateMap Uses

func (opts CreateOpts) ToServerCreateMap() (map[string]interface{}, error)

ToServerCreateMap assembles a request body based on the contents of a CreateOpts.

type CreateOptsBuilder Uses

type CreateOptsBuilder interface {
    ToServerCreateMap() (map[string]interface{}, error)
}

CreateOptsBuilder describes struct types that can be accepted by the Create call. The CreateOpts struct in this package does.

type CreateResult Uses

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

CreateResult temporarily contains the response from a Create call.

func Create Uses

func Create(client *gophercloud.ServiceClient, opts CreateOptsBuilder) CreateResult

Create requests a server to be provisioned to the user in the current tenant.

func (CreateResult) Extract Uses

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

Extract interprets any serverResult as a Server, if possible.

type DeleteMetadatumResult Uses

type DeleteMetadatumResult struct {
    gophercloud.ErrResult
}

DeleteMetadatumResult temporarily contains the response from a metadatum Delete call.

func DeleteMetadatum Uses

func DeleteMetadatum(client *gophercloud.ServiceClient, id, key string) DeleteMetadatumResult

DeleteMetadatum will delete the key-value pair with the given key for the given server ID.

type DeleteResult Uses

type DeleteResult struct {
    gophercloud.ErrResult
}

DeleteResult temporarily contains the response from a Delete call.

func Delete Uses

func Delete(client *gophercloud.ServiceClient, id string) DeleteResult

Delete requests that a server previously provisioned be removed from your account.

type ErrArgument Uses

type ErrArgument struct {
    Function, Argument string
    Value              interface{}
}

ErrArgument errors occur when an argument supplied to a package function fails to fall within acceptable values. For example, the Reboot() function expects the "how" parameter to be one of HardReboot or SoftReboot. These constants are (currently) strings, leading someone to wonder if they can pass other string values instead, perhaps in an effort to break the API of their provider. Reboot() returns this error in this situation.

Function identifies which function was called/which function is generating the error. Argument identifies which formal argument was responsible for producing the error. Value provides the value as it was passed into the function.

func (*ErrArgument) Error Uses

func (e *ErrArgument) Error() string

Error yields a useful diagnostic for debugging purposes.

func (*ErrArgument) String Uses

func (e *ErrArgument) String() string

type File Uses

type File struct {
    // Path of the file
    Path string
    // Contents of the file. Maximum content size is 255 bytes.
    Contents []byte
}

File is used within CreateOpts and RebuildOpts to inject a file into the server at launch. File implements the json.Marshaler interface, so when a Create or Rebuild operation is requested, json.Marshal will call File's MarshalJSON method.

func (*File) MarshalJSON Uses

func (f *File) MarshalJSON() ([]byte, error)

MarshalJSON marshals the escaped file, base64 encoding the contents.

type GetMetadataResult Uses

type GetMetadataResult struct {
    MetadataResult
}

GetMetadataResult temporarily contains the response from a metadata Get call.

func Metadata Uses

func Metadata(client *gophercloud.ServiceClient, id string) GetMetadataResult

Metadata requests all the metadata for the given server ID.

type GetMetadatumResult Uses

type GetMetadatumResult struct {
    MetadatumResult
}

GetMetadatumResult temporarily contains the response from a metadatum Get call.

func Metadatum Uses

func Metadatum(client *gophercloud.ServiceClient, id, key string) GetMetadatumResult

Metadatum requests the key-value pair with the given key for the given server ID.

type GetPasswordResult Uses

type GetPasswordResult struct {
    gophercloud.Result
}

GetPasswordResult represent the result of a get os-server-password operation.

func GetPassword Uses

func GetPassword(client *gophercloud.ServiceClient, serverId string) GetPasswordResult

GetPassword makes a request against the nova API to get the encrypted administrative password.

func (GetPasswordResult) ExtractPassword Uses

func (r GetPasswordResult) ExtractPassword(privateKey *rsa.PrivateKey) (string, error)

ExtractPassword gets the encrypted password. If privateKey != nil the password is decrypted with the private key. If privateKey == nil the encrypted password is returned and can be decrypted with:

echo '<pwd>' | base64 -D | openssl rsautl -decrypt -inkey <private_key>

type GetResult Uses

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

GetResult temporarily contains the response from a Get call.

func Get Uses

func Get(client *gophercloud.ServiceClient, id string) GetResult

Get requests details on a single server, by ID.

func (GetResult) Extract Uses

func (r GetResult) Extract() (*Server, error)

Extract interprets any serverResult as a Server, if possible.

type ListOpts Uses

type ListOpts struct {
    // A time/date stamp for when the server last changed status.
    ChangesSince string `q:"changes-since"`

    // Name of the image in URL format.
    Image string `q:"image"`

    // Name of the flavor in URL format.
    Flavor string `q:"flavor"`

    // Name of the server as a string; can be queried with regular expressions.
    // Realize that ?name=bob returns both bob and bobb. If you need to match bob
    // only, you can use a regular expression matching the syntax of the
    // underlying database server implemented for Compute.
    Name string `q:"name"`

    // Value of the status of the server so that you can filter on "ACTIVE" for example.
    Status string `q:"status"`

    // Name of the host as a string.
    Host string `q:"host"`

    // UUID of the server at which you want to set a marker.
    Marker string `q:"marker"`

    // Integer value for the limit of values to return.
    Limit int `q:"limit"`

    // Bool to show all tenants
    AllTenants bool `q:"all_tenants"`
}

ListOpts allows the filtering and sorting of paginated collections through the API. Filtering is achieved by passing in struct field values that map to the server attributes you want to see returned. Marker and Limit are used for pagination.

func (ListOpts) ToServerListQuery Uses

func (opts ListOpts) ToServerListQuery() (string, error)

ToServerListQuery formats a ListOpts into a query string.

type ListOptsBuilder Uses

type ListOptsBuilder interface {
    ToServerListQuery() (string, error)
}

ListOptsBuilder allows extensions to add additional parameters to the List request.

type MetadataOpts Uses

type MetadataOpts map[string]string

MetadataOpts is a map that contains key-value pairs.

func (MetadataOpts) ToMetadataResetMap Uses

func (opts MetadataOpts) ToMetadataResetMap() (map[string]interface{}, error)

ToMetadataResetMap assembles a body for a Reset request based on the contents of a MetadataOpts.

func (MetadataOpts) ToMetadataUpdateMap Uses

func (opts MetadataOpts) ToMetadataUpdateMap() (map[string]interface{}, error)

ToMetadataUpdateMap assembles a body for an Update request based on the contents of a MetadataOpts.

type MetadataResult Uses

type MetadataResult struct {
    gophercloud.Result
}

MetadataResult contains the result of a call for (potentially) multiple key-value pairs.

func (MetadataResult) Extract Uses

func (r MetadataResult) Extract() (map[string]string, error)

Extract interprets any MetadataResult as a Metadata, if possible.

type MetadatumOpts Uses

type MetadatumOpts map[string]string

MetadatumOpts is a map of length one that contains a key-value pair.

func (MetadatumOpts) ToMetadatumCreateMap Uses

func (opts MetadatumOpts) ToMetadatumCreateMap() (map[string]interface{}, string, error)

ToMetadatumCreateMap assembles a body for a Create request based on the contents of a MetadataumOpts.

type MetadatumOptsBuilder Uses

type MetadatumOptsBuilder interface {
    ToMetadatumCreateMap() (map[string]interface{}, string, error)
}

MetadatumOptsBuilder allows extensions to add additional parameters to the Create request.

type MetadatumResult Uses

type MetadatumResult struct {
    gophercloud.Result
}

MetadatumResult contains the result of a call for individual a single key-value pair.

func (MetadatumResult) Extract Uses

func (r MetadatumResult) Extract() (map[string]string, error)

Extract interprets any MetadatumResult as a Metadatum, if possible.

type Network Uses

type Network struct {
    // UUID of a nova-network to attach to the newly provisioned server.
    // Required unless Port is provided.
    UUID string

    // Port of a neutron network to attach to the newly provisioned server.
    // Required unless UUID is provided.
    Port string

    // FixedIP [optional] specifies a fixed IPv4 address to be used on this network.
    FixedIP string
}

Network is used within CreateOpts to control a new server's network attachments.

type NetworkAddressPage Uses

type NetworkAddressPage struct {
    pagination.SinglePageBase
}

NetworkAddressPage abstracts the raw results of making a ListAddressesByNetwork() request against the API. As OpenStack extensions may freely alter the response bodies of structures returned to the client, you may only safely access the data provided through the ExtractAddresses call.

func (NetworkAddressPage) IsEmpty Uses

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

IsEmpty returns true if a NetworkAddressPage contains no addresses.

type Personality Uses

type Personality []*File

Personality is an array of files that are injected into the server at launch.

type RebootMethod Uses

type RebootMethod string

RebootMethod describes the mechanisms by which a server reboot can be requested.

const (
    SoftReboot RebootMethod = "SOFT"
    HardReboot RebootMethod = "HARD"
    OSReboot                = SoftReboot
    PowerCycle              = HardReboot
)

These constants determine how a server should be rebooted. See the Reboot() function for further details.

type RebuildOpts Uses

type RebuildOpts struct {
    // Required. The ID of the image you want your server to be provisioned on
    ImageID string

    // Name to set the server to
    Name string

    // Required. The server's admin password
    AdminPass string

    // AccessIPv4 [optional] provides a new IPv4 address for the instance.
    AccessIPv4 string

    // AccessIPv6 [optional] provides a new IPv6 address for the instance.
    AccessIPv6 string

    // Metadata [optional] contains key-value pairs (up to 255 bytes each) to attach to the server.
    Metadata map[string]string

    // Personality [optional] includes files to inject into the server at launch.
    // Rebuild will base64-encode file contents for you.
    Personality Personality
}

RebuildOpts represents the configuration options used in a server rebuild operation

func (RebuildOpts) ToServerRebuildMap Uses

func (opts RebuildOpts) ToServerRebuildMap() (map[string]interface{}, error)

ToServerRebuildMap formats a RebuildOpts struct into a map for use in JSON

type RebuildOptsBuilder Uses

type RebuildOptsBuilder interface {
    ToServerRebuildMap() (map[string]interface{}, error)
}

RebuildOptsBuilder is an interface that allows extensions to override the default behaviour of rebuild options

type RebuildResult Uses

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

RebuildResult temporarily contains the response from a Rebuild call.

func Rebuild Uses

func Rebuild(client *gophercloud.ServiceClient, id string, opts RebuildOptsBuilder) RebuildResult

Rebuild will reprovision the server according to the configuration options provided in the RebuildOpts struct.

func (RebuildResult) Extract Uses

func (r RebuildResult) Extract() (*Server, error)

Extract interprets any serverResult as a Server, if possible.

type RescueOpts Uses

type RescueOpts struct {
    // AdminPass is the desired administrative password for the instance in
    // RESCUE mode. If it's left blank, the server will generate a password.
    AdminPass string
}

RescueOpts represents the configuration options used to control a Rescue option.

func (RescueOpts) ToServerRescueMap Uses

func (opts RescueOpts) ToServerRescueMap() (map[string]interface{}, error)

ToServerRescueMap formats a RescueOpts as a map that can be used as a JSON request body for the Rescue request.

type RescueOptsBuilder Uses

type RescueOptsBuilder interface {
    ToServerRescueMap() (map[string]interface{}, error)
}

RescueOptsBuilder is an interface that allows extensions to override the default structure of a Rescue request.

type RescueResult Uses

type RescueResult struct {
    ActionResult
}

RescueResult represents the result of a server rescue operation

func Rescue Uses

func Rescue(client *gophercloud.ServiceClient, id string, opts RescueOptsBuilder) RescueResult

Rescue instructs the provider to place the server into RESCUE mode.

func (RescueResult) Extract Uses

func (r RescueResult) Extract() (string, error)

Extract interprets any RescueResult as an AdminPass, if possible.

type ResetMetadataOptsBuilder Uses

type ResetMetadataOptsBuilder interface {
    ToMetadataResetMap() (map[string]interface{}, error)
}

ResetMetadataOptsBuilder allows extensions to add additional parameters to the Reset request.

type ResetMetadataResult Uses

type ResetMetadataResult struct {
    MetadataResult
}

ResetMetadataResult temporarily contains the response from a metadata Reset call.

func ResetMetadata Uses

func ResetMetadata(client *gophercloud.ServiceClient, id string, opts ResetMetadataOptsBuilder) ResetMetadataResult

ResetMetadata will create multiple new key-value pairs for the given server ID. Note: Using this operation will erase any already-existing metadata and create the new metadata provided. To keep any already-existing metadata, use the UpdateMetadatas or UpdateMetadata function.

type ResizeOpts Uses

type ResizeOpts struct {
    // FlavorRef is the ID of the flavor you wish your server to become.
    FlavorRef string
}

ResizeOpts represents the configuration options used to control a Resize operation.

func (ResizeOpts) ToServerResizeMap Uses

func (opts ResizeOpts) ToServerResizeMap() (map[string]interface{}, error)

ToServerResizeMap formats a ResizeOpts as a map that can be used as a JSON request body for the Resize request.

type ResizeOptsBuilder Uses

type ResizeOptsBuilder interface {
    ToServerResizeMap() (map[string]interface{}, error)
}

ResizeOptsBuilder is an interface that allows extensions to override the default structure of a Resize request.

type Server Uses

type Server struct {
    // ID uniquely identifies this server amongst all other servers, including those not accessible to the current tenant.
    ID  string

    // TenantID identifies the tenant owning this server resource.
    TenantID string `mapstructure:"tenant_id"`

    // UserID uniquely identifies the user account owning the tenant.
    UserID string `mapstructure:"user_id"`

    // Name contains the human-readable name for the server.
    Name string

    // Updated and Created contain ISO-8601 timestamps of when the state of the server last changed, and when it was created.
    Updated string
    Created string

    HostID string

    // Status contains the current operational status of the server, such as IN_PROGRESS or ACTIVE.
    Status string

    // Progress ranges from 0..100.
    // A request made against the server completes only once Progress reaches 100.
    Progress int

    // AccessIPv4 and AccessIPv6 contain the IP addresses of the server, suitable for remote access for administration.
    AccessIPv4, AccessIPv6 string

    // Image refers to a JSON object, which itself indicates the OS image used to deploy the server.
    Image map[string]interface{}

    // Flavor refers to a JSON object, which itself indicates the hardware configuration of the deployed server.
    Flavor map[string]interface{}

    // Addresses includes a list of all IP addresses assigned to the server, keyed by pool.
    Addresses map[string]interface{}

    // Metadata includes a list of all user-specified key-value pairs attached to the server.
    Metadata map[string]interface{}

    // Links includes HTTP references to the itself, useful for passing along to other APIs that might want a server reference.
    Links []interface{}

    // KeyName indicates which public key was injected into the server on launch.
    KeyName string `json:"key_name" mapstructure:"key_name"`

    // AdminPass will generally be empty ("").  However, it will contain the administrative password chosen when provisioning a new server without a set AdminPass setting in the first place.
    // Note that this is the ONLY time this field will be valid.
    AdminPass string `json:"adminPass" mapstructure:"adminPass"`

    // SecurityGroups includes the security groups that this instance has applied to it
    SecurityGroups []map[string]interface{} `json:"security_groups" mapstructure:"security_groups"`
}

Server exposes only the standard OpenStack fields corresponding to a given server on the user's account.

type ServerPage Uses

type ServerPage struct {
    pagination.LinkedPageBase
}

ServerPage abstracts the raw results of making a List() request against the API. As OpenStack extensions may freely alter the response bodies of structures returned to the client, you may only safely access the data provided through the ExtractServers call.

func (ServerPage) IsEmpty Uses

func (page ServerPage) IsEmpty() (bool, error)

IsEmpty returns true if a page contains no Server results.

func (ServerPage) NextPageURL Uses

func (page ServerPage) NextPageURL() (string, error)

NextPageURL uses the response's embedded link reference to navigate to the next page of results.

type UpdateMetadataOptsBuilder Uses

type UpdateMetadataOptsBuilder interface {
    ToMetadataUpdateMap() (map[string]interface{}, error)
}

UpdateMetadataOptsBuilder allows extensions to add additional parameters to the Create request.

type UpdateMetadataResult Uses

type UpdateMetadataResult struct {
    MetadataResult
}

UpdateMetadataResult temporarily contains the response from a metadata Update call.

func UpdateMetadata Uses

func UpdateMetadata(client *gophercloud.ServiceClient, id string, opts UpdateMetadataOptsBuilder) UpdateMetadataResult

UpdateMetadata updates (or creates) all the metadata specified by opts for the given server ID. This operation does not affect already-existing metadata that is not specified by opts.

type UpdateOpts Uses

type UpdateOpts struct {
    // Name [optional] changes the displayed name of the server.
    // The server host name will *not* change.
    // Server names are not constrained to be unique, even within the same tenant.
    Name string

    // AccessIPv4 [optional] provides a new IPv4 address for the instance.
    AccessIPv4 string

    // AccessIPv6 [optional] provides a new IPv6 address for the instance.
    AccessIPv6 string
}

UpdateOpts specifies the base attributes that may be updated on an existing server.

func (UpdateOpts) ToServerUpdateMap Uses

func (opts UpdateOpts) ToServerUpdateMap() map[string]interface{}

ToServerUpdateMap formats an UpdateOpts structure into a request body.

type UpdateOptsBuilder Uses

type UpdateOptsBuilder interface {
    ToServerUpdateMap() map[string]interface{}
}

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

type UpdateResult Uses

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

UpdateResult temporarily contains the response from an Update call.

func Update Uses

func Update(client *gophercloud.ServiceClient, id string, opts UpdateOptsBuilder) UpdateResult

Update requests that various attributes of the indicated server be changed.

func (UpdateResult) Extract Uses

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

Extract interprets any serverResult as a Server, if possible.

Package servers imports 13 packages (graph) and is imported by 356 packages. Updated 2016-07-21. Refresh now. Tools for package owners.