terraform/vendor/github.com/sethvargo/go-fastly/cache_setting.go

238 lines
6.3 KiB
Go

package fastly
import (
"fmt"
"sort"
)
const (
// CacheSettingActionCache sets the cache to cache.
CacheSettingActionCache CacheSettingAction = "cache"
// CacheSettingActionPass sets the cache to pass through.
CacheSettingActionPass CacheSettingAction = "pass"
// CacheSettingActionRestart sets the cache to restart the request.
CacheSettingActionRestart CacheSettingAction = "restart"
)
// CacheSettingAction is the type of cache action.
type CacheSettingAction string
// CacheSetting represents a response from Fastly's API for cache settings.
type CacheSetting struct {
ServiceID string `mapstructure:"service_id"`
Version string `mapstructure:"version"`
Name string `mapstructure:"name"`
Action CacheSettingAction `mapstructure:"action"`
TTL uint `mapstructure:"ttl"`
StaleTTL uint `mapstructure:"stale_ttl"`
CacheCondition string `mapstructure:"cache_condition"`
}
// cacheSettingsByName is a sortable list of cache settings.
type cacheSettingsByName []*CacheSetting
// Len, Swap, and Less implement the sortable interface.
func (s cacheSettingsByName) Len() int { return len(s) }
func (s cacheSettingsByName) Swap(i, j int) { s[i], s[j] = s[j], s[i] }
func (s cacheSettingsByName) Less(i, j int) bool {
return s[i].Name < s[j].Name
}
// ListCacheSettingsInput is used as input to the ListCacheSettings function.
type ListCacheSettingsInput struct {
// Service is the ID of the service (required).
Service string
// Version is the specific configuration version (required).
Version string
}
// ListCacheSettings returns the list of cache settings for the configuration
// version.
func (c *Client) ListCacheSettings(i *ListCacheSettingsInput) ([]*CacheSetting, error) {
if i.Service == "" {
return nil, ErrMissingService
}
if i.Version == "" {
return nil, ErrMissingVersion
}
path := fmt.Sprintf("/service/%s/version/%s/cache_settings", i.Service, i.Version)
resp, err := c.Get(path, nil)
if err != nil {
return nil, err
}
var cs []*CacheSetting
if err := decodeJSON(&cs, resp.Body); err != nil {
return nil, err
}
sort.Stable(cacheSettingsByName(cs))
return cs, nil
}
// CreateCacheSettingInput is used as input to the CreateCacheSetting function.
type CreateCacheSettingInput struct {
// Service is the ID of the service. Version is the specific configuration
// version. Both fields are required.
Service string
Version string
Name string `form:"name,omitempty"`
Action CacheSettingAction `form:"action,omitempty"`
TTL uint `form:"ttl,omitempty"`
StaleTTL uint `form:"stale_ttl,omitempty"`
CacheCondition string `form:"cache_condition,omitempty"`
}
// CreateCacheSetting creates a new Fastly cache setting.
func (c *Client) CreateCacheSetting(i *CreateCacheSettingInput) (*CacheSetting, error) {
if i.Service == "" {
return nil, ErrMissingService
}
if i.Version == "" {
return nil, ErrMissingVersion
}
path := fmt.Sprintf("/service/%s/version/%s/cache_settings", i.Service, i.Version)
resp, err := c.PostForm(path, i, nil)
if err != nil {
return nil, err
}
var cs *CacheSetting
if err := decodeJSON(&cs, resp.Body); err != nil {
return nil, err
}
return cs, nil
}
// GetCacheSettingInput is used as input to the GetCacheSetting function.
type GetCacheSettingInput struct {
// Service is the ID of the service. Version is the specific configuration
// version. Both fields are required.
Service string
Version string
// Name is the name of the cache setting to fetch.
Name string
}
// GetCacheSetting gets the cache setting configuration with the given
// parameters.
func (c *Client) GetCacheSetting(i *GetCacheSettingInput) (*CacheSetting, error) {
if i.Service == "" {
return nil, ErrMissingService
}
if i.Version == "" {
return nil, ErrMissingVersion
}
if i.Name == "" {
return nil, ErrMissingName
}
path := fmt.Sprintf("/service/%s/version/%s/cache_settings/%s", i.Service, i.Version, i.Name)
resp, err := c.Get(path, nil)
if err != nil {
return nil, err
}
var cs *CacheSetting
if err := decodeJSON(&cs, resp.Body); err != nil {
return nil, err
}
return cs, nil
}
// UpdateCacheSettingInput is used as input to the UpdateCacheSetting function.
type UpdateCacheSettingInput struct {
// Service is the ID of the service. Version is the specific configuration
// version. Both fields are required.
Service string
Version string
// Name is the name of the cache setting to update.
Name string
NewName string `form:"name,omitempty"`
Action CacheSettingAction `form:"action,omitempty"`
TTL uint `form:"ttl,omitempty"`
StateTTL uint `form:"stale_ttl,omitempty"`
CacheCondition string `form:"cache_condition,omitempty"`
}
// UpdateCacheSetting updates a specific cache setting.
func (c *Client) UpdateCacheSetting(i *UpdateCacheSettingInput) (*CacheSetting, error) {
if i.Service == "" {
return nil, ErrMissingService
}
if i.Version == "" {
return nil, ErrMissingVersion
}
if i.Name == "" {
return nil, ErrMissingName
}
path := fmt.Sprintf("/service/%s/version/%s/cache_settings/%s", i.Service, i.Version, i.Name)
resp, err := c.PutForm(path, i, nil)
if err != nil {
return nil, err
}
var cs *CacheSetting
if err := decodeJSON(&cs, resp.Body); err != nil {
return nil, err
}
return cs, nil
}
// DeleteCacheSettingInput is the input parameter to DeleteCacheSetting.
type DeleteCacheSettingInput struct {
// Service is the ID of the service. Version is the specific configuration
// version. Both fields are required.
Service string
Version string
// Name is the name of the cache setting to delete (required).
Name string
}
// DeleteCacheSetting deletes the given cache setting version.
func (c *Client) DeleteCacheSetting(i *DeleteCacheSettingInput) error {
if i.Service == "" {
return ErrMissingService
}
if i.Version == "" {
return ErrMissingVersion
}
if i.Name == "" {
return ErrMissingName
}
path := fmt.Sprintf("/service/%s/version/%s/cache_settings/%s", i.Service, i.Version, i.Name)
resp, err := c.Delete(path, nil)
if err != nil {
return err
}
var r *statusResp
if err := decodeJSON(&r, resp.Body); err != nil {
return err
}
if !r.Ok() {
return fmt.Errorf("Not Ok")
}
return nil
}