gophercloud openstack networking 源码分析

阿娇开发978

　　1、network 部分
　　// Package networks contains functionality for working with Neutron network resources.
　　// A network is an isolated virtual lay-2 broadcast domain that is typically reserved for
　　// the tenant who created it (unless you configure the network to be shared). Tenants
　　// can create multiple networks until the thresholds per-tenant quota is reached
　　//
　　// In the v2.0 Networking API, the network is the main entity. Ports and subnets are
　　// always associated with a networ
　　// networking/v2/networks/requests.go
　　// Create accepts a CreateOpts struct and creates a new network using the values
　　// provided. This operation does not actually require a request body , i.e. the
　　// CreateOpts struct argument can be empty.
　　//
　　// The tenant ID that is containd in the URI is the tenant that creates the network.
　　// An admin user, however, has the option of specifying another tenant ID in the
　　// CreateOpts struct.
　　1、func Create(c *gophercloud.ServiceClient, opts CreateOptsBuilder)
　　1、首先调用b, err := opts.ToNetworkCreateMap()，将CreateOpts结构转换为一个map
　　2、调用_, r.Err = c.Post(createURL(c), b, &r.Body, nil)
　　CreateOpts结构如下所示：
　　type CreateOpts struct {
　　AdminStateUp　　　　*bool
　　Name　　　　　　　　 string
　　Shared　　　　　　　　*bool
　　TenantID　　　　　　　string
　　}
　　2、router部分
　　// networking/v2/extensions/layer3/routers/requests.go
　　// Create accepts a CreateOpts struct and uses the values to create a new
　　// logical router. When it is created, the router does not have an inernal interface -
　　// it is not associated to any subnet.
　　//
　　// You can optionally specify an external gateway for a router using the
　　// GatewayInfo struct. The external gateway for the router must be plugged into
　　// an external network (it is external if its `router:external` field is set to true)
　　func Create(c *gophercloud.ServiceClient, opts CreateOptsBuilder) (r CreateResult)
　　// networking/v2/extensions/layer3/routers/requests.go
　　// AddInterface attaches a subnet to an internal router interface. You must specify
　　// either a SubnetID or PortID in the request body. If you specify both, the operation
　　// will fail and an error will be returned
　　//
　　// If you specify a SubnetID, the gateway IP address for that particular subnet is
　　// used to create the router interface. Alternatively, if you specify a PortID, the IP
　　// address associated with the port is used to create the router interface.
　　//
　　// If you reference a port that is associated with multiple IP addresses, or if the port
　　// is associated with zero IP addresses, the operation will fail and a 400 Bad Request
　　// error will be returned.
　　//
　　// If you reference a port already in use, the operation will fail and a 409 Conflict
　　// error will be returned.
　　//
　　// The PortID that is returned using Extract() on the result of this operation can
　　// either be the same PortID passed in or, on the other hand, the identifier of a new
　　// port created by this operation. After the operation completes, the device ID of the
　　// port is set to the router ID, and the device owner attribute is set to
　　// `network:router_interface`.
　　func AddInterface(c *gophercloud.ServiceClient, id string, opts AddInterfaceOptsBuilder) (r InterfaceResult)
　　3、subnet部分
　　// Package subnets containsj functionality for working with Neutron subnet resources
　　// A subnet represents an IP address block that can be used to assign IP addresses
　　// to virtual instances. Each subnet must have a CIDR and must be associated with a
　　// network. IPs can either be selected from the whole subnet CIDR or from allocation
　　// pools specified by the user.
　　//
　　// A subnet can also have a gateway, a list of DNS name servers, and host routes.
　　// This information is pushed to instances whose interfaces are associated with the
　　// subnet
　　// networking/v2/subnets/requests.go
　　// Create accepts a CreateOpts struct and creates a new subnet using the values
　　// provided. You must remember to provide a valid NetworkID, CIDR and IP Version.
　　func Create(c *gophercloud.ServiceClient, opts CreateOptsBuilder) (r CreateResult)
　　4、port部分
　　// Package ports contains functionality for working with Neutron port resources.
　　// A port represents a virtual switch port on a logical network switch. Virtual
　　// instances attach theri interfaces into ports. The logical port also defines the MAC
　　// address and the IP address(es) to be assigned to the interfaces plugged into them
　　// When IP addresses are associated to a port, this is also implies the port is
　　// associated with a subnet, as the IP address was taken from the allocation pool for
　　// a specific subnet.