eip

Documentation

Overview

Package eip defines the EIP services of BCE. The supported APIs are all defined in sub-package

eip.go - the eip APIs definition supported by the EIP service

model.go - definitions of the request arguments and results data structure model

Index

• Constants
• type Billing
• type BindEipArgs
• type Client
  • func NewClient(ak, sk, endPoint string) (*Client, error)
  • func (c *Client) BindEip(eip string, args *BindEipArgs) error
  • func (c *Client) CreateEip(args *CreateEipArgs) (*CreateEipResult, error)
  • func (c *Client) DeleteEip(eip, clientToken string) error
  • func (c *Client) ListEip(args *ListEipArgs) (*ListEipResult, error)
  • func (c *Client) PurchaseReservedEip(eip string, args *PurchaseReservedEipArgs) error
  • func (c *Client) ResizeEip(eip string, args *ResizeEipArgs) error
  • func (c *Client) StartAutoRenew(eip string, args *StartAutoRenewArgs) error
  • func (c *Client) StopAutoRenew(eip string, clientToken string) error
  • func (c *Client) UnBindEip(eip, clientToken string) error
• type CreateEipArgs
• type CreateEipResult
• type EipModel
• type ListEipArgs
• type ListEipResult
• type PurchaseReservedEipArgs
• type Reservation
• type ResizeEipArgs
• type StartAutoRenewArgs

Constants

const (
	URI_PREFIX = bce.URI_PREFIX + "v1"

	DEFAULT_ENDPOINT = "eip." + bce.DEFAULT_REGION + ".baidubce.com"

	REQUEST_EIP_URL = "/eip"
)

Types

type Billing

type Billing struct {
	PaymentTiming string       `json:"paymentTiming,omitempty"`
	BillingMethod string       `json:"billingMethod,omitempty"`
	Reservation   *Reservation `json:"reservation,omitempty"`
}

type BindEipArgs

type BindEipArgs struct {
	InstanceType string `json:"instanceType"`
	InstanceId   string `json:"instanceId"`
	ClientToken  string `json:"-"`
}

type Client

type Client struct {
	*bce.BceClient
}

Client of EIP service is a kind of BceClient, so derived from BceClient

func NewClient

func NewClient(ak, sk, endPoint string) (*Client, error)

func (*Client) BindEip

func (c *Client) BindEip(eip string, args *BindEipArgs) error

BindEip - bind an EIP to an instance with the specific parameters

PARAMS:

• eip: the specific EIP
• args: the arguments to bind an EIP

RETURNS:

• error: nil if success otherwise the specific error

func (*Client) CreateEip

func (c *Client) CreateEip(args *CreateEipArgs) (*CreateEipResult, error)

CreateEip - create an EIP with the specific parameters

PARAMS:

• args: the arguments to create an eip

RETURNS:

• *CreateEipResult: the result of create EIP, contains new EIP's address
• error: nil if success otherwise the specific error

func (*Client) DeleteEip

func (c *Client) DeleteEip(eip, clientToken string) error

DeleteEip - delete an EIP

PARAMS:

• eip: the specific EIP
• clientToken: optional parameter, an Idempotent Token

RETURNS:

• error: nil if success otherwise the specific error

func (*Client) ListEip

func (c *Client) ListEip(args *ListEipArgs) (*ListEipResult, error)

ListEip - list all EIP with the specific parameters

PARAMS:

• args: the arguments to list all eip

RETURNS:

• *ListEipResult: the result of list all eip, contains new EIP's ID
• error: nil if success otherwise the specific error

func (*Client) PurchaseReservedEip

func (c *Client) PurchaseReservedEip(eip string, args *PurchaseReservedEipArgs) error

PurchaseReservedEip - purchase reserve an eip with the specific parameters

PARAMS:

• eip: the specific EIP
• args: the arguments to purchase reserve an eip

RETURNS:

• error: nil if success otherwise the specific error

func (*Client) ResizeEip

func (c *Client) ResizeEip(eip string, args *ResizeEipArgs) error

ResizeEip - resize an EIP with the specific parameters

PARAMS:

• eip: the specific EIP
• args: the arguments to resize an EIP

RETURNS:

• error: nil if success otherwise the specific error

func (*Client) StartAutoRenew

func (c *Client) StartAutoRenew(eip string, args *StartAutoRenewArgs) error

StartAutoRenew - start auto renew an eip

PARAMS:

• eip: the specific EIP
• args: the arguments to start auto renew an eip

RETURNS:

• error: nil if success otherwise the specific error

func (*Client) StopAutoRenew

func (c *Client) StopAutoRenew(eip string, clientToken string) error

StopAutoRenew - stop eip auto renew

PARAMS:

• eip: the specific EIP
• clientToken: optional parameter, an Idempotent Token

RETURNS:

• error: nil if success otherwise the specific error

func (*Client) UnBindEip

func (c *Client) UnBindEip(eip, clientToken string) error

UnBindEip - unbind an EIP

PARAMS:

• eip: the specific EIP
• clientToken: optional parameter, an Idempotent Token

RETURNS:

• error: nil if success otherwise the specific error

type CreateEipArgs

type CreateEipArgs struct {
	Name              string           `json:"name,omitempty"`
	BandWidthInMbps   int              `json:"bandwidthInMbps"`
	Billing           *Billing         `json:"billing"`
	Tags              []model.TagModel `json:"tags"`
	AutoRenewTimeUnit string           `json:"autoRenewTimeUnit,omitempty"`
	AutoRenewTime     int              `json:"autoRenewTime,omitempty"`
	ClientToken       string           `json:"-"`
}

type CreateEipResult

type CreateEipResult struct {
	Eip string `json:"eip"`
}

type EipModel

type EipModel struct {
	Name            string           `json:"name"`
	Eip             string           `json:"eip"`
	Status          string           `json:"status"`
	EipInstanceType string           `json:"eipInstanceType"`
	InstanceType    string           `json:"instanceType"`
	InstanceId      string           `json:"instanceId"`
	ShareGroupId    string           `json:"shareGroupId"`
	BandWidthInMbps int              `json:"bandwidthInMbps"`
	PaymentTiming   string           `json:"paymentTiming"`
	BillingMethod   string           `json:"billingMethod"`
	CreateTime      string           `json:"createTime"`
	ExpireTime      string           `json:"expireTime"`
	Tags            []model.TagModel `json:"tags"`
}

type ListEipArgs

type ListEipArgs struct {
	Eip          string
	InstanceType string
	InstanceId   string
	Marker       string
	MaxKeys      int
	Status       string
}

type ListEipResult

type ListEipResult struct {
	Marker      string     `json:"marker"`
	MaxKeys     int        `json:"maxKeys"`
	NextMarker  string     `json:"nextMarker"`
	IsTruncated bool       `json:"isTruncated"`
	EipList     []EipModel `json:"eipList"`
}

type PurchaseReservedEipArgs

type PurchaseReservedEipArgs struct {
	Billing     *Billing `json:"billing"`
	ClientToken string   `json:"clientToken"`
}

type Reservation

type Reservation struct {
	ReservationLength   int    `json:"reservationLength,omitempty"`
	ReservationTimeUnit string `json:"reservationTimeUnit,omitempty"`
}

type ResizeEipArgs

type ResizeEipArgs struct {
	NewBandWidthInMbps int    `json:"newBandwidthInMbps"`
	ClientToken        string `json:"-"`
}

type StartAutoRenewArgs

type StartAutoRenewArgs struct {
	AutoRenewTimeUnit string `json:"autoRenewTimeUnit,omitempty"`
	AutoRenewTime     int    `json:"autoRenewTime,omitempty"`
	ClientToken       string `json:"-"`
}