recordsets

Documentation

Overview

Package recordsets provides information and interaction with the zone API resource for the OpenStack DNS service.

For more information, see: http://developer.openstack.org/api-ref/dns/#recordsets

Index

• func ListByZone(client *gophercloud.ServiceClient, zoneID string, opts ListOptsBuilder) pagination.Pager
• type CreateOpts
  • func (opts CreateOpts) ToRecordSetCreateMap() (map[string]interface{}, error)
• type CreateOptsBuilder
• type CreateResult
  • func Create(client *gophercloud.ServiceClient, zoneID string, opts CreateOptsBuilder) (r CreateResult)
  • func (r CreateResult) Extract() (*RecordSet, error)
• type DeleteResult
  • func Delete(client *gophercloud.ServiceClient, zoneID string, rrsetID string) (r DeleteResult)
• type GetResult
  • func Get(client *gophercloud.ServiceClient, zoneID string, rrsetID string) (r GetResult)
  • func (r GetResult) Extract() (*RecordSet, error)
• type ListOpts
  • func (opts ListOpts) ToRecordSetListQuery() (string, error)
• type ListOptsBuilder
• type RecordSet
  • func ExtractRecordSets(r pagination.Page) ([]RecordSet, error)
  • func (r *RecordSet) UnmarshalJSON(b []byte) error
• type RecordSetPage
  • func (r RecordSetPage) IsEmpty() (bool, error)
• type UpdateOpts
  • func (opts UpdateOpts) ToRecordSetUpdateMap() (map[string]interface{}, error)
• type UpdateOptsBuilder
• type UpdateResult
  • func Update(client *gophercloud.ServiceClient, zoneID string, rrsetID string, ...) (r UpdateResult)
  • func (r UpdateResult) Extract() (*RecordSet, error)

Functions

func ListByZone

func ListByZone(client *gophercloud.ServiceClient, zoneID string, opts ListOptsBuilder) pagination.Pager

ListByZone implements the recordset list request.

Types

type CreateOpts

type CreateOpts struct {
	// Name is the name of the RecordSet.
	Name string `json:"name" required:"true"`

	// Description is a description of the RecordSet.
	Description string `json:"description,omitempty"`

	// Records are the DNS records of the RecordSet.
	Records []string `json:"records,omitempty"`

	// TTL is the time to live of the RecordSet.
	TTL int `json:"ttl,omitempty"`

	// Type is the RRTYPE of the RecordSet.
	Type string `json:"type,omitempty"`
}

CreateOpts specifies the base attributes that may be used to create a RecordSet.

func (CreateOpts) ToRecordSetCreateMap

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

ToRecordSetCreateMap formats an CreateOpts structure into a request body.

type CreateOptsBuilder

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

CreateOptsBuilder allows extensions to add additional attributes to the Create request.

type CreateResult

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

CreateResult is the deferred result of a Create call.

func Create

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

Create creates a recordset in a given zone.

func (CreateResult) Extract

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

Extract interprets a GetResult, CreateResult or UpdateResult as a concrete RecordSet. An error is returned if the original call or the extraction failed.

type DeleteResult

type DeleteResult struct {
	gophercloud.ErrResult
}

DeleteResult is the deferred result of an Delete call.

func Delete

func Delete(client *gophercloud.ServiceClient, zoneID string, rrsetID string) (r DeleteResult)

Delete removes an existing RecordSet.

type GetResult

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

GetResult is the deferred result of a Get call.

func Get

func Get(client *gophercloud.ServiceClient, zoneID string, rrsetID string) (r GetResult)

Get implements the recordset get request.

func (GetResult) Extract

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

Extract interprets a GetResult, CreateResult or UpdateResult as a concrete RecordSet. An error is returned if the original call or the extraction failed.

type ListOpts

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

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

	Data        string `q:"data"`
	Description string `q:"description"`
	Name        string `q:"name"`
	SortDir     string `q:"sort_dir"`
	SortKey     string `q:"sort_key"`
	Status      string `q:"status"`
	TTL         int    `q:"ttl"`
	Type        string `q:"type"`
	ZoneID      string `q:"zone_id"`
}

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. https://developer.openstack.org/api-ref/dns/

func (ListOpts) ToRecordSetListQuery

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

ToRecordSetListQuery formats a ListOpts into a query string.

type ListOptsBuilder

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

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

type RecordSet

type RecordSet struct {
	// ID is the unique ID of the recordset
	ID string `json:"id"`

	// ZoneID is the ID of the zone the recordset belongs to.
	ZoneID string `json:"zone_id"`

	// ProjectID is the ID of the project that owns the recordset.
	ProjectID string `json:"project_id"`

	// Name is the name of the recordset.
	Name string `json:"name"`

	// ZoneName is the name of the zone the recordset belongs to.
	ZoneName string `json:"zone_name"`

	// Type is the RRTYPE of the recordset.
	Type string `json:"type"`

	// Records are the DNS records of the recordset.
	Records []string `json:"records"`

	// TTL is the time to live of the recordset.
	TTL int `json:"ttl"`

	// Status is the status of the recordset.
	Status string `json:"status"`

	// Action is the current action in progress of the recordset.
	Action string `json:"action"`

	// Description is the description of the recordset.
	Description string `json:"description"`

	// Version is the revision of the recordset.
	Version int `json:"version"`

	// CreatedAt is the date when the recordset was created.
	CreatedAt time.Time `json:"-"`

	// UpdatedAt is the date when the recordset was updated.
	UpdatedAt time.Time `json:"-"`

	// Links includes HTTP references to the itself,
	// useful for passing along to other APIs that might want a recordset reference.
	Links []gophercloud.Link `json:"-"`
}

func ExtractRecordSets

func ExtractRecordSets(r pagination.Page) ([]RecordSet, error)

ExtractRecordSets extracts a slice of RecordSets from a Collection acquired from List.

func (*RecordSet) UnmarshalJSON

func (r *RecordSet) UnmarshalJSON(b []byte) error

type RecordSetPage

type RecordSetPage struct {
	pagination.LinkedPageBase
}

RecordSetPage is a single page of RecordSet results.

func (RecordSetPage) IsEmpty

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

IsEmpty returns true if the page contains no results.

type UpdateOpts

type UpdateOpts struct {
	Description string   `json:"description,omitempty"`
	TTL         int      `json:"ttl,omitempty"`
	Records     []string `json:"records,omitempty"`
}

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

func (UpdateOpts) ToRecordSetUpdateMap

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

ToRecordSetUpdateMap formats an UpdateOpts structure into a request body.

type UpdateOptsBuilder

type UpdateOptsBuilder interface {
	ToRecordSetUpdateMap() (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 is the deferred result of an Update call.

func Update

func Update(client *gophercloud.ServiceClient, zoneID string, rrsetID string, opts UpdateOptsBuilder) (r UpdateResult)

Update updates a recordset in a given zone

func (UpdateResult) Extract

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

Extract interprets a GetResult, CreateResult or UpdateResult as a concrete RecordSet. An error is returned if the original call or the extraction failed.