~zulcss/ubuntu/precise/python-novaclient/new

« back to all changes in this revision

Viewing changes to doc/source/ref/ipgroups.rst

  • Committer: Package Import Robot
  • Author(s): Chuck Short
  • Date: 2012-06-22 13:05:33 UTC
  • mfrom: (1.1.21)
  • Revision ID: package-import@ubuntu.com-20120622130533-1p96cml55ohtf02u
Tags: 2012.2~f2~20120618.605-0ubuntu1
New upstream release. 

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
Shared IP addresses
 
2
===================
 
3
 
 
4
From the Rackspace API guide:
 
5
 
 
6
    Public IP addresses can be shared across multiple servers for use in
 
7
    various high availability scenarios. When an IP address is shared to
 
8
    another server, the cloud network restrictions are modified to allow each
 
9
    server to listen to and respond on that IP address (you may optionally
 
10
    specify that the target server network configuration be modified). Shared
 
11
    IP addresses can be used with many standard heartbeat facilities (e.g.
 
12
    ``keepalived``) that monitor for failure and manage IP failover.
 
13
 
 
14
    A shared IP group is a collection of servers that can share IPs with other
 
15
    members of the group. Any server in a group can share one or more public
 
16
    IPs with any other server in the group. With the exception of the first
 
17
    server in a shared IP group, servers must be launched into shared IP
 
18
    groups. A server may only be a member of one shared IP group.
 
19
 
 
20
.. seealso::
 
21
 
 
22
    Use :meth:`Server.share_ip` and `Server.unshare_ip` to share and unshare
 
23
    IPs in a group.
 
24
 
 
25
Classes
 
26
-------
 
27
 
 
28
.. currentmodule:: novaclient
 
29
 
 
30
.. autoclass:: IPGroupManager
 
31
   :members: get, list, find, findall, create, delete
 
32
   
 
33
.. autoclass:: IPGroup
 
34
   :members: delete
 
35
   
 
36
   .. attribute:: id
 
37
   
 
38
        Shared group ID.
 
39
   
 
40
   .. attribute:: name
 
41
   
 
42
        Name of the group.
 
43
   
 
44
   .. attribute:: servers
 
45
   
 
46
        A list of server IDs in this group.