client

package
v5.1.6+incompatible Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jan 19, 2022 License: Apache-2.0, BSD-2-Clause, BSD-3-Clause, + 1 more Imports: 19 Imported by: 0

README

TO Client Library Golang

Getting Started

  1. Obtain the latest version of the library

go get github.com/apache/trafficcontrol/traffic_ops/client

  1. Get a basic TO session started and fetch a list of CDNs
package main

import (
	"fmt"
	"os"
	"time"

	"github.com/apache/trafficcontrol/lib/go-tc"
	toclient "github.com/apache/trafficcontrol/traffic_ops/client"
)

const TOURL = "http://localhost"
const TOUser = "user"
const TOPassword = "password"
const AllowInsecureConnections = true
const UserAgent = "MySampleApp"
const UseClientCache = false
const TrafficOpsRequestTimeout = time.Second * time.Duration(10)

func main() {
	session, remoteaddr, err := toclient.LoginWithAgent(
		TOURL,
		TOUser,
		TOPassword,
		AllowInsecureConnections,
		UserAgent,
		UseClientCache,
		TrafficOpsRequestTimeout)
	if err != nil {
		fmt.Printf("An error occurred while logging in:\n\t%v\n", err)
		os.Exit(1)
	}
	fmt.Println("Connected to: " + remoteaddr.String())
	var cdns []v13.CDN
	cdns, _, err = session.GetCDNs()
	if err != nil {
		fmt.Printf("An error occurred while getting cdns:\n\t%v\n", err)
		os.Exit(1)
	}
	for _, cdn := range cdns {
		fmt.Println(cdn.Name)
	}
}

Documentation

Overview

Package client provides Go bindings to the Traffic Ops RPC API.

Index

Constants

View Source 
const (
	API_v13_Profile_Parameters = "/api/1.3/profileparameters"
	ProfileIdQueryParam        = "profileId"
	ParameterIdQueryParam      = "parameterId"
)
View Source 
const (
	API_v13_Servers                        = "/api/1.3/servers"
	API_SERVERS_DETAILS                    = apiBase + "/servers/details"
	API_v14_Server_Assign_DeliveryServices = "/api/1.4/servers/%d/deliveryservices?replace=%t"
	API_v14_Server_DeliveryServices        = "/api/1.4/servers/%d/deliveryservices"
)
View Source 
const (
	APIServerCapabilities = apiBase + "/server_capabilities"
)
View Source 
const APIServersStatus = apiBase + "/servers/status"
View Source 
const (
	API_DS_REQUESTS = "/api/1.3/deliveryservice_requests"
)
View Source 
const API_TO_EXTENSION = apiBase + "/to_extensions"
View Source 
const (
	API_V13_Coordinates = "/api/1.3/coordinates"
)
View Source 
const API_V13_SERVERCHECK = "/api/1.3/servercheck"
View Source 
const API_V1_SERVERCHECK_GET = apiBase + "/servers/checks"
View Source 
const (
	API_v11_OSVERSIONS = "/api/1.1/osversions"
)
View Source 
const (
	API_v13_ABOUT = "/api/1.3/about"
)
View Source 
const (
	API_v13_CDNs = "/api/1.3/cdns"
)
View Source 
const (
	API_v13_CacheGroups = "/api/1.3/cachegroups"
)
View Source 
const (
	API_v13_DeliveryServiceRequestComments = "/api/1.3/deliveryservice_request_comments"
)
View Source 
const (
	API_v13_Divisions = "/api/1.3/divisions"
)
View Source 
const (
	API_v13_Origins = "/api/1.3/origins"
)
View Source 
const (
	API_v13_PING = "/api/1.3/ping"
)
View Source 
const (
	API_v13_Parameters = "/api/1.3/parameters"
)
View Source 
const (
	API_v13_PhysLocations = "/api/1.3/phys_locations"
)
View Source 
const (
	API_v13_REGIONS = "/api/1.3/regions"
)
View Source 
const (
	API_v13_STATUSES = "/api/1.3/statuses"
)
View Source 
const (
	API_v13_StaticDNSEntries = "/api/1.3/staticdnsentries"
)
View Source 
const (
	API_v13_Types = "/api/1.3/types"
)
View Source 
const API_v14_CAPABILITIES = "/api/1.4/capabilities"
View Source 
const (
	API_v14_ROLES = "/api/1.4/roles"
)
View Source 
const (
	API_v14_Server_Server_Capabilities = apiBase + "/server_server_capabilities"
)
View Source 
const (
	API_v1_CacheGroupParameters = apiBase + "/cachegroupparameters"
)
View Source 
const (
	API_v1_Logs = apiBase + "/logs"
)
View Source 
const (
	API_v2_ASNs = "/api/1.3/asns"
)
View Source 
const CacheHitStatusExpired = CacheHitStatus("expired")
View Source 
const CacheHitStatusHit = CacheHitStatus("hit")
View Source 
const CacheHitStatusInvalid = CacheHitStatus("")
View Source 
const CacheHitStatusMiss = CacheHitStatus("miss")
View Source 
const DefaultTimeout = time.Second * time.Duration(30)
View Source 
const UpdateStatusClear = 0

UpdateStatusClear is the value received by and posted to the Traffic Ops cache update endpoint, indicating no updates are pending for a cache.

View Source 
const UpdateStatusPending = 1

UpdateStatusPending is the value received by and posted to the Traffic Ops cache update endpoint, indicating an update is pending for a cache. That is, someone has clicked "Queue Updates" in Traffic Ops, and the cache has yet to run ORT, which will fetch updates and clear the update pending flag.

Variables

This section is empty.

Functions

This section is empty.

Types

type CacheEntry 

type CacheEntry struct {
	Entered    int64
	Bytes      []byte
	RemoteAddr net.Addr
}

CacheEntry ...

type CacheHitStatus 

type CacheHitStatus string

func StringToCacheHitStatus 

func StringToCacheHitStatus(s string) CacheHitStatus

func (CacheHitStatus) String 

func (s CacheHitStatus) String() string

type HTTPError 

type HTTPError struct {
	HTTPStatusCode int
	HTTPStatus     string
	URL            string
	Body           string
}

HTTPError is returned on Update Session failure.

func (*HTTPError) Error 

func (e *HTTPError) Error() string

Error implements the error interface for our customer error type.

type OuterResponse 

type OuterResponse struct {
	Response json.RawMessage `json:"response"`
}

type ReqInf 

type ReqInf struct {
	CacheHitStatus CacheHitStatus
	RemoteAddr     net.Addr
}

type Session 

type Session struct {
	UserName string
	Password string
	URL      string
	Client   *http.Client

	UserAgentStr string
	// contains filtered or unexported fields
}

Session ...

func LoginWithAgent 

func LoginWithAgent(toURL string, toUser string, toPasswd string, insecure bool, userAgent string, useCache bool, requestTimeout time.Duration) (*Session, net.Addr, error)

Login to traffic_ops, the response should set the cookie for this session automatically. Start with 

to := traffic_ops.Login("user", "passwd", true)

subsequent calls like to.GetData("datadeliveryservice") will be authenticated. Returns the logged in client, the remote address of Traffic Ops which was translated and used to log in, and any error. If the error is not nil, the remote address may or may not be nil, depending whether the error occurred before the login request.

func LoginWithToken 

func LoginWithToken(toURL string, token string, insecure bool, userAgent string, useCache bool, requestTimeout time.Duration) (*Session, net.Addr, error)

func LogoutWithAgent 

func LogoutWithAgent(toURL string, toUser string, toPasswd string, insecure bool, userAgent string, useCache bool, requestTimeout time.Duration) (*Session, net.Addr, error)

Logout of traffic_ops

func NewNoAuthSession 

func NewNoAuthSession(toURL string, insecure bool, userAgent string, useCache bool, requestTimeout time.Duration) *Session

NewNoAuthSession returns a new Session without logging in this can be used for querying unauthenticated endpoints without requiring a login

func NewSession 

func NewSession(user, password, url, userAgent string, client *http.Client, useCache bool) *Session

func (*Session) AddFederationResolverMappingsForCurrentUser 

func (to *Session) AddFederationResolverMappingsForCurrentUser(mappings tc.DeliveryServiceFederationResolverMappingRequest) (tc.Alerts, ReqInf, error)

AddFederationResolverMappingsForCurrentUser adds Federation Resolver mappings to one or more Delivery Services for the current user.

func (*Session) AllFederations 

func (to *Session) AllFederations() ([]tc.AllDeliveryServiceFederationsMapping, ReqInf, error)

func (*Session) AllFederationsForCDN 

func (to *Session) AllFederationsForCDN(cdnName string) ([]tc.AllDeliveryServiceFederationsMapping, ReqInf, error)

func (*Session) AssignDeliveryServiceIDsToServerID 

func (to *Session) AssignDeliveryServiceIDsToServerID(server int, dsIDs []int, replace bool) (tc.Alerts, ReqInf, error)

AssignDeliveryServiceIDsToServerID assigns a set of Delivery Services to a single server, optionally replacing any and all existing assignments. 'server' should be the requested server's ID, 'dsIDs' should be a slice of the requested Delivery Services' IDs. If 'replace' is 'true', existing assignments to the server will be replaced.

func (*Session) AssignFederationFederationResolver 

func (to *Session) AssignFederationFederationResolver(fedID int, resolverIDs []int, replace bool) (tc.AssignFederationFederationResolversResponse, ReqInf, error)

AssignFederationFederationResolver creates the Federation Resolver 'fr'.

func (*Session) CopyProfile 

func (to *Session) CopyProfile(p tc.ProfileCopy) (tc.ProfileCopyResponse, ReqInf, error)

CopyProfile creates a new profile from an existing profile.

func (*Session) CreateASN 

func (to *Session) CreateASN(entity tc.ASN) (tc.Alerts, ReqInf, error)

Create a ASN

func (*Session) CreateCDN 

func (to *Session) CreateCDN(cdn tc.CDN) (tc.Alerts, ReqInf, error)

Create a CDN

func (*Session) CreateCDNFederationByName 

func (to *Session) CreateCDNFederationByName(f tc.CDNFederation, CDNName string) (*tc.CreateCDNFederationResponse, ReqInf, error)

func (*Session) CreateCacheGroupNullable 

func (to *Session) CreateCacheGroupNullable(cachegroup tc.CacheGroupNullable) (*tc.CacheGroupDetailResponse, ReqInf, error)

Create a CacheGroup

func (*Session) CreateCacheGroupParameter 

func (to *Session) CreateCacheGroupParameter(cacheGroupID, parameterID int) (*tc.CacheGroupParametersPostResponse, ReqInf, error)

CreateCacheGroupParameter Associates a Parameter with a Cache Group

func (*Session) CreateCapability 

func (to *Session) CreateCapability(c tc.Capability) (tc.Alerts, ReqInf, error)

CreateCapability creates the passed capability.

func (*Session) CreateCoordinate 

func (to *Session) CreateCoordinate(coordinate tc.Coordinate) (tc.Alerts, ReqInf, error)

Create a Coordinate

func (*Session) CreateDeliveryService 

func (to *Session) CreateDeliveryService(ds *tc.DeliveryService) (*tc.CreateDeliveryServiceResponse, error)

CreateDeliveryService creates the DeliveryService it's passed

func (*Session) CreateDeliveryServiceNullable 

func (to *Session) CreateDeliveryServiceNullable(ds *tc.DeliveryServiceNullable) (*tc.CreateDeliveryServiceNullableResponse, error)

CreateDeliveryServiceNullable creates the DeliveryService it's passed

func (*Session) CreateDeliveryServiceRequest 

func (to *Session) CreateDeliveryServiceRequest(dsr tc.DeliveryServiceRequest) (tc.Alerts, ReqInf, error)

Create a Delivery Service Request

func (*Session) CreateDeliveryServiceRequestComment 

func (to *Session) CreateDeliveryServiceRequestComment(comment tc.DeliveryServiceRequestComment) (tc.Alerts, ReqInf, error)

Create a delivery service request comment

func (*Session) CreateDeliveryServiceServers 

func (to *Session) CreateDeliveryServiceServers(dsID int, serverIDs []int, replace bool) (*tc.DSServerIDs, error)

CreateDeliveryServiceServers associates the given servers with the given delivery services. If replace is true, it deletes any existing associations for the given delivery service.

func (*Session) CreateDeliveryServicesRequiredCapability 

func (to *Session) CreateDeliveryServicesRequiredCapability(capability tc.DeliveryServicesRequiredCapability) (tc.Alerts, ReqInf, error)

CreateDeliveryServicesRequiredCapability assigns a Required Capability to a Delivery Service

func (*Session) CreateDivision 

func (to *Session) CreateDivision(division tc.Division) (tc.Alerts, ReqInf, error)

Create a Division

func (*Session) CreateFederationDeliveryServices 

func (to *Session) CreateFederationDeliveryServices(federationID int, deliveryServiceIDs []int, replace bool) (ReqInf, error)

func (*Session) CreateFederationResolver 

func (to *Session) CreateFederationResolver(fr tc.FederationResolver) (tc.Alerts, ReqInf, error)

CreateFederationResolver creates the Federation Resolver 'fr'.

func (*Session) CreateFederationUsers 

func (to *Session) CreateFederationUsers(federationID int, userIDs []int, replace bool) (tc.Alerts, ReqInf, error)

GetFederationUsers Associates the given Users' IDs to a Federation

func (*Session) CreateInvalidationJob 

func (to *Session) CreateInvalidationJob(job tc.InvalidationJobInput) (tc.Alerts, ReqInf, error)

Creates a new Content Invalidation Job

func (*Session) CreateMultipleParameters 

func (to *Session) CreateMultipleParameters(pls []tc.Parameter) (tc.Alerts, ReqInf, error)

CreateMultipleParameters performs a POST to create multiple Parameters at once.

func (*Session) CreateMultipleProfileParameters 

func (to *Session) CreateMultipleProfileParameters(pps []tc.ProfileParameter) (tc.Alerts, ReqInf, error)

CreateMultipleProfileParameters creates multiple ProfileParameters at once.

func (*Session) CreateOrigin 

func (to *Session) CreateOrigin(origin tc.Origin) (*tc.OriginDetailResponse, ReqInf, error)

Create an Origin

func (*Session) CreateParameter 

func (to *Session) CreateParameter(pl tc.Parameter) (tc.Alerts, ReqInf, error)

Create a Parameter

func (*Session) CreatePhysLocation 

func (to *Session) CreatePhysLocation(pl tc.PhysLocation) (tc.Alerts, ReqInf, error)

Create a PhysLocation

func (*Session) CreateProfile 

func (to *Session) CreateProfile(pl tc.Profile) (tc.Alerts, ReqInf, error)

CreateProfile creates a Profile

func (*Session) CreateProfileParameter 

func (to *Session) CreateProfileParameter(pp tc.ProfileParameter) (tc.Alerts, ReqInf, error)

Create a ProfileParameter

func (*Session) CreateRegion 

func (to *Session) CreateRegion(region tc.Region) (tc.Alerts, ReqInf, error)

Create a Region

func (*Session) CreateRole 

func (to *Session) CreateRole(region tc.Role) (tc.Alerts, ReqInf, int, error)

Create a Role

func (*Session) CreateServer 

func (to *Session) CreateServer(server tc.ServerV1) (tc.Alerts, ReqInf, error)

Create a Server

func (*Session) CreateServerCapability 

func (to *Session) CreateServerCapability(sc tc.ServerCapability) (*tc.ServerCapabilityDetailResponse, ReqInf, error)

CreateServerCapability creates a server capability and returns the response.

func (*Session) CreateServerServerCapability 

func (to *Session) CreateServerServerCapability(ssc tc.ServerServerCapability) (tc.Alerts, ReqInf, error)

CreateServerServerCapability assigns a Server Capability to a Server

func (*Session) CreateStaticDNSEntry 

func (to *Session) CreateStaticDNSEntry(sdns tc.StaticDNSEntry) (tc.Alerts, ReqInf, error)

Create a StaticDNSEntry

func (*Session) CreateStatus 

func (to *Session) CreateStatus(status tc.Status) (tc.Alerts, ReqInf, error)

Create a Status

func (*Session) CreateStatusNullable 

func (to *Session) CreateStatusNullable(status tc.StatusNullable) (tc.Alerts, ReqInf, error)

func (*Session) CreateSteeringTarget 

func (to *Session) CreateSteeringTarget(st tc.SteeringTargetNullable) (tc.Alerts, ReqInf, error)

func (*Session) CreateSummaryStats 

func (to *Session) CreateSummaryStats(statsSummary tc.StatsSummary) (tc.Alerts, ReqInf, error)

CreateSummaryStats creates a stats summary

func (*Session) CreateTOExtension 

func (to *Session) CreateTOExtension(toExtension tc.TOExtensionNullable) (tc.Alerts, ReqInf, error)

CreateTOExtension creates a to_extension

func (*Session) CreateTenant 

func (to *Session) CreateTenant(t *tc.Tenant) (*tc.TenantResponse, error)

CreateTenant creates the Tenant it's passed

func (*Session) CreateType 

func (to *Session) CreateType(typ tc.Type) (tc.Alerts, ReqInf, error)

Create a Type

func (*Session) CreateUser 

func (to *Session) CreateUser(user *tc.User) (*tc.CreateUserResponse, ReqInf, error)

CreateUser creates a user

func (*Session) DeleteASNByASN 

func (to *Session) DeleteASNByASN(asn int) (tc.Alerts, ReqInf, error)

DELETE an ASN by asn number

func (*Session) DeleteCDNByID 

func (to *Session) DeleteCDNByID(id int) (tc.Alerts, ReqInf, error)

DELETE a CDN by ID

func (*Session) DeleteCDNFederationByID 

func (to *Session) DeleteCDNFederationByID(CDNName string, ID int) (*tc.DeleteCDNFederationResponse, ReqInf, error)

func (*Session) DeleteCacheGroupByID 

func (to *Session) DeleteCacheGroupByID(id int) (tc.Alerts, ReqInf, error)

DELETE a CacheGroup by ID

func (*Session) DeleteCacheGroupParameter 

func (to *Session) DeleteCacheGroupParameter(cacheGroupID, parameterID int) (tc.Alerts, ReqInf, error)

DeleteCacheGroupParameter Deassociates a Parameter with a Cache Group

func (*Session) DeleteCoordinateByID 

func (to *Session) DeleteCoordinateByID(id int) (tc.Alerts, ReqInf, error)

DELETE a Coordinate by ID

func (*Session) DeleteDeliveryService 

func (to *Session) DeleteDeliveryService(id string) (*tc.DeleteDeliveryServiceResponse, error)

DeleteDeliveryService deletes the DeliveryService matching the ID it's passed

func (*Session) DeleteDeliveryServiceRequestByID 

func (to *Session) DeleteDeliveryServiceRequestByID(id int) (tc.Alerts, ReqInf, error)

DELETE a DeliveryServiceRequest by DeliveryServiceRequest assignee

func (*Session) DeleteDeliveryServiceRequestCommentByID 

func (to *Session) DeleteDeliveryServiceRequestCommentByID(id int) (tc.Alerts, ReqInf, error)

DELETE a delivery service request comment by ID

func (*Session) DeleteDeliveryServiceServer 

func (to *Session) DeleteDeliveryServiceServer(dsID int, serverID int) (tc.Alerts, ReqInf, error)

func (*Session) DeleteDeliveryServiceUser 

func (to *Session) DeleteDeliveryServiceUser(userID int, dsID int) (*tc.UserDeliveryServiceDeleteResponse, error)

DeleteDeliveryServiceUser deletes the association between the given delivery service and user

func (*Session) DeleteDeliveryServicesRequiredCapability 

func (to *Session) DeleteDeliveryServicesRequiredCapability(deliveryserviceID int, capability string) (tc.Alerts, ReqInf, error)

DeleteDeliveryServicesRequiredCapability unassigns a Required Capability from a Delivery Service

func (*Session) DeleteDivisionByID 

func (to *Session) DeleteDivisionByID(id int) (tc.Alerts, ReqInf, error)

DELETE a Division by Division id

func (*Session) DeleteFederationDeliveryService 

func (to *Session) DeleteFederationDeliveryService(federationID, deliveryServiceID int) (tc.Alerts, ReqInf, error)

DeleteFederationDeliveryService Deletes a given Delivery Service from a Federation

func (*Session) DeleteFederationResolver 

func (to *Session) DeleteFederationResolver(id uint) (tc.Alerts, ReqInf, error)

DeleteFederationResolver deletes the Federation Resolver identified by 'id'.

func (*Session) DeleteFederationResolverMappingsForCurrentUser 

func (to *Session) DeleteFederationResolverMappingsForCurrentUser() (tc.Alerts, ReqInf, error)

DeleteFederationResolverMappingsForCurrentUser removes ALL Federation Resolver mappings for ALL Federations assigned to the currently authenticated user, as well as deleting ALL of the Federation Resolvers themselves.

func (*Session) DeleteFederationUser 

func (to *Session) DeleteFederationUser(federationID, userID int) (tc.Alerts, ReqInf, error)

DeleteFederationUser Deletes a given User from a Federation

func (*Session) DeleteOriginByID 

func (to *Session) DeleteOriginByID(id int) (tc.Alerts, ReqInf, error)

DELETE an Origin by ID

func (*Session) DeleteParameterByID 

func (to *Session) DeleteParameterByID(id int) (tc.Alerts, ReqInf, error)

DELETE a Parameter by ID

func (*Session) DeleteParameterByProfileParameter 

func (to *Session) DeleteParameterByProfileParameter(profile int, parameter int) (tc.Alerts, ReqInf, error)

DELETE a Parameter by Parameter

func (*Session) DeletePhysLocationByID 

func (to *Session) DeletePhysLocationByID(id int) (tc.Alerts, ReqInf, error)

DELETE a PhysLocation by ID

func (*Session) DeleteProfileByID 

func (to *Session) DeleteProfileByID(id int) (tc.Alerts, ReqInf, error)

DeleteProfileByID DELETEs a Profile by ID

func (*Session) DeleteRegion 

func (to *Session) DeleteRegion(id *int, name *string) (tc.Alerts, ReqInf, error)

DeleteRegion lets you DELETE a Region. Only 1 parameter is required, not both.

func (*Session) DeleteRegionByID 

func (to *Session) DeleteRegionByID(id int) (tc.Alerts, ReqInf, error)

DELETE a Region by ID

func (*Session) DeleteRoleByID 

func (to *Session) DeleteRoleByID(id int) (tc.Alerts, ReqInf, int, error)

DELETE a Role by ID

func (*Session) DeleteServerByID 

func (to *Session) DeleteServerByID(id int) (tc.Alerts, ReqInf, error)

DELETE a Server by ID

func (*Session) DeleteServerCapability 

func (to *Session) DeleteServerCapability(name string) (tc.Alerts, ReqInf, error)

DeleteServerCapability deletes the given server capability by name.

func (*Session) DeleteServerServerCapability 

func (to *Session) DeleteServerServerCapability(serverID int, serverCapability string) (tc.Alerts, ReqInf, error)

DeleteServerServerCapability unassigns a Server Capability from a Server

func (*Session) DeleteStaticDNSEntryByID 

func (to *Session) DeleteStaticDNSEntryByID(id int) (tc.Alerts, ReqInf, error)

DELETE a StaticDNSEntry by ID

func (*Session) DeleteStatusByID 

func (to *Session) DeleteStatusByID(id int) (tc.Alerts, ReqInf, error)

DELETE a Status by id

func (*Session) DeleteSteeringTarget 

func (to *Session) DeleteSteeringTarget(dsID int, targetID int) (tc.Alerts, ReqInf, error)

func (*Session) DeleteTOExtension 

func (to *Session) DeleteTOExtension(id int) (tc.Alerts, ReqInf, error)

DeleteToExtension deletes a to_extension

func (*Session) DeleteTenant 

func (to *Session) DeleteTenant(id string) (*tc.DeleteTenantResponse, error)

DeleteTenant deletes the Tenant matching the ID it's passed

func (*Session) DeleteTypeByID 

func (to *Session) DeleteTypeByID(id int) (tc.Alerts, ReqInf, error)

DELETE a Type by ID

func (*Session) DeleteUserByID 

func (to *Session) DeleteUserByID(id int) (tc.Alerts, ReqInf, error)

DeleteUserByID updates user with the given id

func (*Session) ErrUnlessOK 

func (to *Session) ErrUnlessOK(resp *http.Response, remoteAddr net.Addr, err error, path string) (*http.Response, net.Addr, error)

ErrUnlessOk returns nil and an error if the given Response's status code is anything but 200 OK. This includes reading the Response.Body and Closing it. Otherwise, the given response and error are returned unchanged.

func (*Session) ExportProfile 

func (to *Session) ExportProfile(id int) (*tc.ProfileExportResponse, ReqInf, error)

ExportProfile Returns an exported Profile

func (*Session) Federations 

func (to *Session) Federations() ([]tc.AllDeliveryServiceFederationsMapping, ReqInf, error)

func (*Session) GetAPICapabilities 

func (to *Session) GetAPICapabilities(capability string, order string) (tc.APICapabilityResponse, ReqInf, error)

GetAPICapabilities will retrieve API Capabilities. In the event that no capability parameter is supplied, it will return all existing. If a capability is supplied, it will return only those with an exact match. Order may be specified to change the default sort order.

func (*Session) GetASNByASN 

func (to *Session) GetASNByASN(asn int) ([]tc.ASN, ReqInf, error)

GET an ASN by the asn number

func (*Session) GetASNByID 

func (to *Session) GetASNByID(id int) ([]tc.ASN, ReqInf, error)

GET a ASN by the id

func (*Session) GetASNs 

func (to *Session) GetASNs() ([]tc.ASN, ReqInf, error)

Returns a list of ASNs

func (*Session) GetATSCDNConfig 

func (to *Session) GetATSCDNConfig(cdnID int, fileName string) (string, ReqInf, error)

func (*Session) GetATSCDNConfigByName 

func (to *Session) GetATSCDNConfigByName(cdnName string, fileName string) (string, ReqInf, error)

func (*Session) GetATSProfileConfig 

func (to *Session) GetATSProfileConfig(profileID int, fileName string) (string, ReqInf, error)

func (*Session) GetATSProfileConfigByName 

func (to *Session) GetATSProfileConfigByName(profileName string, fileName string) (string, ReqInf, error)

func (*Session) GetATSServerConfig 

func (to *Session) GetATSServerConfig(serverID int, fileName string) (string, ReqInf, error)

func (*Session) GetATSServerConfigByName 

func (to *Session) GetATSServerConfigByName(serverHostName string, fileName string) (string, ReqInf, error)

func (*Session) GetATSServerConfigList 

func (to *Session) GetATSServerConfigList(serverID int) (tc.ATSConfigMetaData, ReqInf, error)

func (*Session) GetATSServerConfigListByName 

func (to *Session) GetATSServerConfigListByName(serverHostName string) (tc.ATSConfigMetaData, ReqInf, error)

func (*Session) GetAbout 

func (to *Session) GetAbout() (map[string]string, ReqInf, error)

GetAbout gets data about the TO instance

func (*Session) GetAllCacheGroupParameters 

func (to *Session) GetAllCacheGroupParameters() ([]tc.CacheGroupParametersResponseNullable, ReqInf, error)

GetAllCacheGroupParameters Gets all Cachegroup Parameter associations

func (*Session) GetCDNByID 

func (to *Session) GetCDNByID(id int) ([]tc.CDN, ReqInf, error)

GET a CDN by the CDN ID

func (*Session) GetCDNByName 

func (to *Session) GetCDNByName(name string) ([]tc.CDN, ReqInf, error)

GET a CDN by the CDN name

func (*Session) GetCDNFederationsByID 

func (to *Session) GetCDNFederationsByID(CDNName string, ID int) (*tc.CDNFederationResponse, ReqInf, error)

func (*Session) GetCDNFederationsByName 

func (to *Session) GetCDNFederationsByName(CDNName string) (*tc.CDNFederationResponse, ReqInf, error)

func (*Session) GetCDNSSLKeys 

func (to *Session) GetCDNSSLKeys(name string) ([]tc.CDNSSLKeys, ReqInf, error)

func (*Session) GetCDNs 

func (to *Session) GetCDNs() ([]tc.CDN, ReqInf, error)

Returns a list of CDNs

func (*Session) GetCRConfig 

func (to *Session) GetCRConfig(cdn string) ([]byte, ReqInf, error)

GetCRConfig returns the raw JSON bytes of the CRConfig from Traffic Ops, and whether the bytes were from the client's internal cache.

func (*Session) GetCRConfigNew 

func (to *Session) GetCRConfigNew(cdn string) ([]byte, ReqInf, error)

GetCRConfigNew returns the raw JSON bytes of the CRConfig from Traffic Ops, and whether the bytes were from the client's internal cache.

func (*Session) GetCacheGroupNullableByID 

func (to *Session) GetCacheGroupNullableByID(id int) ([]tc.CacheGroupNullable, ReqInf, error)

GET a CacheGroup by the CacheGroup id

func (*Session) GetCacheGroupNullableByName 

func (to *Session) GetCacheGroupNullableByName(name string) ([]tc.CacheGroupNullable, ReqInf, error)

GET a CacheGroup by the CacheGroup name

func (*Session) GetCacheGroupParameters 

func (to *Session) GetCacheGroupParameters(cacheGroupID int) ([]tc.CacheGroupParameter, ReqInf, error)

GetCacheGroupParameters Gets a Cache Group's Parameters

func (*Session) GetCacheGroupParametersByQueryParams 

func (to *Session) GetCacheGroupParametersByQueryParams(cacheGroupID int, queryParams string) ([]tc.CacheGroupParameter, ReqInf, error)

GetCacheGroupParametersByQueryParams Gets a Cache Group's Parameters with query parameters

func (*Session) GetCacheGroupUnassignedParameters 

func (to *Session) GetCacheGroupUnassignedParameters(cacheGroupID int) ([]tc.CacheGroupParameter, ReqInf, error)

GetCacheGroupUnassignedParameters Gets a Cache Group's Unassigned Parameters

func (*Session) GetCacheGroupUnassignedParametersByQueryParams 

func (to *Session) GetCacheGroupUnassignedParametersByQueryParams(cacheGroupID int, queryParams string) ([]tc.CacheGroupParameter, ReqInf, error)

GetCacheGroupParametersByQueryParams Gets a Cache Group's Unassigned Parameters with query parameters

func (*Session) GetCacheGroupsNullable 

func (to *Session) GetCacheGroupsNullable() ([]tc.CacheGroupNullable, ReqInf, error)

Returns a list of CacheGroups

func (*Session) GetCapabilities 

func (to *Session) GetCapabilities() ([]tc.Capability, ReqInf, error)

GetCapabilities retrieves all capabilities.

func (*Session) GetCapability 

func (to *Session) GetCapability(c string) (tc.Capability, ReqInf, error)

GetCapability retrieves only the capability named 'c'

func (*Session) GetCoordinateByID 

func (to *Session) GetCoordinateByID(id int) ([]tc.Coordinate, ReqInf, error)

GET a Coordinate by the Coordinate id

func (*Session) GetCoordinateByName 

func (to *Session) GetCoordinateByName(name string) ([]tc.Coordinate, ReqInf, error)

GET a Coordinate by the Coordinate name

func (*Session) GetCoordinates 

func (to *Session) GetCoordinates() ([]tc.Coordinate, ReqInf, error)

Returns a list of Coordinates

func (*Session) GetCurrentStats 

func (to *Session) GetCurrentStats() (tc.TrafficStatsCDNStatsResponse, ReqInf, error)

GetCurrentStats gets current stats for each CDNs and a total across them

func (*Session) GetDeliveryService 

func (to *Session) GetDeliveryService(id string) (*tc.DeliveryService, ReqInf, error)

func (*Session) GetDeliveryServiceByXMLIDNullable 

func (to *Session) GetDeliveryServiceByXMLIDNullable(XMLID string) ([]tc.DeliveryServiceNullable, ReqInf, error)

func (*Session) GetDeliveryServiceCapacity 

func (to *Session) GetDeliveryServiceCapacity(id string) (*tc.DeliveryServiceCapacity, ReqInf, error)

func (*Session) GetDeliveryServiceHealth 

func (to *Session) GetDeliveryServiceHealth(id string) (*tc.DeliveryServiceHealth, ReqInf, error)

func (*Session) GetDeliveryServiceMatches 

func (to *Session) GetDeliveryServiceMatches() ([]tc.DeliveryServicePatterns, ReqInf, error)

func (*Session) GetDeliveryServiceNullable 

func (to *Session) GetDeliveryServiceNullable(id string) (*tc.DeliveryServiceNullable, ReqInf, error)

func (*Session) GetDeliveryServiceRegexes 

func (to *Session) GetDeliveryServiceRegexes() ([]tc.DeliveryServiceRegexes, ReqInf, error)

func (*Session) GetDeliveryServiceRequestByID 

func (to *Session) GetDeliveryServiceRequestByID(id int) ([]tc.DeliveryServiceRequest, ReqInf, error)

GET a DeliveryServiceRequest by the DeliveryServiceRequest id

func (*Session) GetDeliveryServiceRequestByXMLID 

func (to *Session) GetDeliveryServiceRequestByXMLID(XMLID string) ([]tc.DeliveryServiceRequest, ReqInf, error)

GET a DeliveryServiceRequest by the DeliveryServiceRequest XMLID

func (*Session) GetDeliveryServiceRequestCommentByID 

func (to *Session) GetDeliveryServiceRequestCommentByID(id int) ([]tc.DeliveryServiceRequestComment, ReqInf, error)

GET a delivery service request comment by ID

func (*Session) GetDeliveryServiceRequestComments 

func (to *Session) GetDeliveryServiceRequestComments() ([]tc.DeliveryServiceRequestComment, ReqInf, error)

Returns a list of delivery service request comments

func (*Session) GetDeliveryServiceRequests 

func (to *Session) GetDeliveryServiceRequests() ([]tc.DeliveryServiceRequest, ReqInf, error)

GetDeliveryServiceRequests retrieves all deliveryservices available to session user.

func (*Session) GetDeliveryServiceRouting 

func (to *Session) GetDeliveryServiceRouting(id string) (*tc.DeliveryServiceRouting, ReqInf, error)

func (*Session) GetDeliveryServiceSSLKeysByHostname 

func (to *Session) GetDeliveryServiceSSLKeysByHostname(hostname string) (*tc.DeliveryServiceSSLKeys, ReqInf, error)

func (*Session) GetDeliveryServiceSSLKeysByID 

func (to *Session) GetDeliveryServiceSSLKeysByID(id string) (*tc.DeliveryServiceSSLKeys, ReqInf, error)

func (*Session) GetDeliveryServiceServer 

func (to *Session) GetDeliveryServiceServer(page, limit string) ([]tc.DeliveryServiceServer, ReqInf, error)

func (*Session) GetDeliveryServiceServers 

func (to *Session) GetDeliveryServiceServers() (tc.DeliveryServiceServerResponse, ReqInf, error)

GetDeliveryServiceServers gets all delivery service servers, with the default API limit.

func (*Session) GetDeliveryServiceServersN 

func (to *Session) GetDeliveryServiceServersN(n int) (tc.DeliveryServiceServerResponse, ReqInf, error)

GetDeliveryServiceServersN gets all delivery service servers, with a limit of n.

func (*Session) GetDeliveryServiceServersWithLimits 

func (to *Session) GetDeliveryServiceServersWithLimits(limit int, deliveryServiceIDs []int, serverIDs []int) (tc.DeliveryServiceServerResponse, ReqInf, error)

GetDeliveryServiceServersWithLimits gets all delivery service servers, allowing specifying the limit of mappings to return, the delivery services to return, and the servers to return. The limit may be 0, in which case the default limit will be applied. The deliveryServiceIDs and serverIDs may be nil or empty, in which case all delivery services and/or servers will be returned.

func (*Session) GetDeliveryServiceState 

func (to *Session) GetDeliveryServiceState(id string) (*tc.DeliveryServiceState, ReqInf, error)

func (*Session) GetDeliveryServiceURISigningKeys 

func (to *Session) GetDeliveryServiceURISigningKeys(dsName string) ([]byte, ReqInf, error)

func (*Session) GetDeliveryServiceURLSigKeys 

func (to *Session) GetDeliveryServiceURLSigKeys(dsName string) (tc.URLSigKeys, ReqInf, error)

func (*Session) GetDeliveryServices 

func (to *Session) GetDeliveryServices() ([]tc.DeliveryService, ReqInf, error)

func (*Session) GetDeliveryServicesByCDNID 

func (to *Session) GetDeliveryServicesByCDNID(cdnID int) ([]tc.DeliveryServiceNullable, ReqInf, error)

func (*Session) GetDeliveryServicesByServer 

func (to *Session) GetDeliveryServicesByServer(id int) ([]tc.DeliveryService, ReqInf, error)

func (*Session) GetDeliveryServicesEligible 

func (to *Session) GetDeliveryServicesEligible(dsID int) ([]tc.DSServerV11, ReqInf, error)

func (*Session) GetDeliveryServicesNullable 

func (to *Session) GetDeliveryServicesNullable() ([]tc.DeliveryServiceNullable, ReqInf, error)

func (*Session) GetDeliveryServicesRequiredCapabilities 

func (to *Session) GetDeliveryServicesRequiredCapabilities(deliveryServiceID *int, xmlID, capability *string) ([]tc.DeliveryServicesRequiredCapability, ReqInf, error)

GetDeliveryServicesRequiredCapabilities retrieves a list of Required Capabilities that are assigned to a Delivery Service Callers can filter the results by delivery service id, xml id and/or required capability via the optional parameters

func (*Session) GetDivisionByID 

func (to *Session) GetDivisionByID(id int) ([]tc.Division, ReqInf, error)

GET a Division by the Division id

func (*Session) GetDivisionByName 

func (to *Session) GetDivisionByName(name string) ([]tc.Division, ReqInf, error)

GET a Division by the Division name

func (*Session) GetDivisions 

func (to *Session) GetDivisions() ([]tc.Division, ReqInf, error)

Returns a list of Divisions

func (*Session) GetDomains 

func (to *Session) GetDomains() ([]tc.Domain, ReqInf, error)

func (*Session) GetFederationDeliveryServices 

func (to *Session) GetFederationDeliveryServices(federationID int) ([]tc.FederationDeliveryServiceNullable, ReqInf, error)

GetFederationDeliveryServices Returns a given Federation's Delivery Services

func (*Session) GetFederationFederationResolversByID 

func (to *Session) GetFederationFederationResolversByID(id int) (tc.FederationFederationResolversResponse, ReqInf, error)

GetFederationFederationResolversByID retrieves all Federation Resolvers belonging to Federation of ID.

func (*Session) GetFederationResolverByID 

func (to *Session) GetFederationResolverByID(ID uint) (tc.FederationResolver, ReqInf, error)

GetFederationResolverByID retrieves a single Federation Resolver identified by ID.

func (*Session) GetFederationResolverByIPAddress 

func (to *Session) GetFederationResolverByIPAddress(ip string) (tc.FederationResolver, ReqInf, error)

GetFederationResolverByIPAddress retrieves the Federation Resolver that uses the IP address or CIDR-notation subnet 'ip'.

func (*Session) GetFederationResolvers 

func (to *Session) GetFederationResolvers() ([]tc.FederationResolver, ReqInf, error)

GetFederationResolvers retrieves all Federation Resolvers from Traffic Ops

func (*Session) GetFederationResolversByType 

func (to *Session) GetFederationResolversByType(t string) ([]tc.FederationResolver, ReqInf, error)

GetFederationResolversByType gets all Federation Resolvers that are of the Type named 't'.

func (*Session) GetFederationUsers 

func (to *Session) GetFederationUsers(federationID int) ([]tc.FederationUser, ReqInf, error)

GetFederationUsers Returns a given Federation's Users

func (*Session) GetInvalidationJobs 

func (to *Session) GetInvalidationJobs(ds *interface{}, user *interface{}) ([]tc.InvalidationJob, ReqInf, error)

Returns a list of Content Invalidation Jobs visible to your Tenant, filtered according to ds and user

Either or both of ds and user may be nil, but when they are not they cause filtering of the returned jobs by Delivery Service and Traffic Ops user, respectively.

ds may be a uint, int, or float64 indicating the integral, unique identifier of the desired Delivery Service (in the case of a float64 the fractional part is dropped, e.g. 3.45 -> 3), or it may be a string, in which case it should be the xml_id of the desired Delivery Service, or it may be an actual tc.DeliveryService or tc.DeliveryServiceNullable structure.

Likewise, user may be a uint, int or float64 indicating the integral, unique identifier of the desired user (in the case of a float64 the fractional part is dropped, e.g. 3.45 -> 3), or it may be a string, in which case it should be the username of the desired user, or it may be an actual tc.User or tc.UserCurrent structure.

func (*Session) GetJobs 

func (to *Session) GetJobs(deliveryServiceID *int, userID *int) ([]tc.Job, ReqInf, error)

GetJobs returns a list of Jobs. If deliveryServiceID or userID are not nil, only jobs for that delivery service or belonging to that user are returned. Both deliveryServiceID and userID may be nil.

Deprecated, use GetInvalidationJobs instead

func (*Session) GetLogs 

func (to *Session) GetLogs() ([]tc.Log, ReqInf, error)

GetLogs gets a list of logs.

func (*Session) GetLogsByDays 

func (to *Session) GetLogsByDays(days int) ([]tc.Log, ReqInf, error)

GetLogsByDays gets a list of logs limited to a certain number of days.

func (*Session) GetLogsByLimit 

func (to *Session) GetLogsByLimit(limit int) ([]tc.Log, ReqInf, error)

GetLogsByLimit gets a list of logs limited to a certain number of logs.

func (*Session) GetLogsByQueryParams 

func (to *Session) GetLogsByQueryParams(queryParams string) ([]tc.Log, ReqInf, error)

GetLogsByQueryParams gets a list of logs filtered by query params.

func (*Session) GetOSVersions 

func (to *Session) GetOSVersions() (map[string]string, ReqInf, error)

GetOSVersions GET all available Operating System (OS) versions for ISO generation, as well as the name of the directory where the "kickstarter" files are found. Structure of returned map: 

key:   Name of OS
value: Directory where the ISO source can be found

func (*Session) GetOriginByID 

func (to *Session) GetOriginByID(id int) ([]tc.Origin, ReqInf, error)

GET an Origin by the Origin ID

func (*Session) GetOriginByName 

func (to *Session) GetOriginByName(name string) ([]tc.Origin, ReqInf, error)

GET an Origin by the Origin name

func (*Session) GetOrigins 

func (to *Session) GetOrigins() ([]tc.Origin, ReqInf, error)

Returns a list of Origins

func (*Session) GetOriginsByDeliveryServiceID 

func (to *Session) GetOriginsByDeliveryServiceID(id int) ([]tc.Origin, ReqInf, error)

GET a list of Origins by Delivery Service ID

func (*Session) GetOriginsByQueryParams 

func (to *Session) GetOriginsByQueryParams(queryParams string) ([]tc.Origin, ReqInf, error)

GET a list of Origins by a query parameter string

func (*Session) GetParameterByConfigFile 

func (to *Session) GetParameterByConfigFile(configFile string) ([]tc.Parameter, ReqInf, error)

GET a Parameter by the Parameter ConfigFile

func (*Session) GetParameterByID 

func (to *Session) GetParameterByID(id int) ([]tc.Parameter, ReqInf, error)

GET a Parameter by the Parameter ID

func (*Session) GetParameterByName 

func (to *Session) GetParameterByName(name string) ([]tc.Parameter, ReqInf, error)

GET a Parameter by the Parameter name

func (*Session) GetParameterByNameAndConfigFile 

func (to *Session) GetParameterByNameAndConfigFile(name string, configFile string) ([]tc.Parameter, ReqInf, error)

GET a Parameter by the Parameter Name and ConfigFile

func (*Session) GetParameterByNameAndConfigFileAndValue 

func (to *Session) GetParameterByNameAndConfigFileAndValue(name, configFile, value string) ([]tc.Parameter, ReqInf, error)

GET a Parameter by the Parameter Name and ConfigFile and Value TODO: API should support all 3, but does not support filter by value currently. Until then, loop thru hits until you find one with that value

func (*Session) GetParameters 

func (to *Session) GetParameters() ([]tc.Parameter, ReqInf, error)

Returns a list of Parameters

func (*Session) GetParametersByProfileName 

func (to *Session) GetParametersByProfileName(profileName string) ([]tc.Parameter, ReqInf, error)

func (*Session) GetPhysLocationByID 

func (to *Session) GetPhysLocationByID(id int) ([]tc.PhysLocation, ReqInf, error)

GET a PhysLocation by the PhysLocation ID

func (*Session) GetPhysLocationByName 

func (to *Session) GetPhysLocationByName(name string) ([]tc.PhysLocation, ReqInf, error)

GET a PhysLocation by the PhysLocation name

func (*Session) GetPhysLocations 

func (to *Session) GetPhysLocations() ([]tc.PhysLocation, ReqInf, error)

Returns a list of PhysLocations

func (*Session) GetProfileByCDNID 

func (to *Session) GetProfileByCDNID(cdnID int) ([]tc.Profile, ReqInf, error)

GetProfileByCDNID GETs a Profile by the Profile cdn id

func (*Session) GetProfileByID 

func (to *Session) GetProfileByID(id int) ([]tc.Profile, ReqInf, error)

GetProfileByID GET a Profile by the Profile ID

func (*Session) GetProfileByName 

func (to *Session) GetProfileByName(name string) ([]tc.Profile, ReqInf, error)

GetProfileByName GET a Profile by the Profile name

func (*Session) GetProfileByParameter 

func (to *Session) GetProfileByParameter(param string) ([]tc.Profile, ReqInf, error)

GetProfileByParameter GETs a Profile by the Profile "param"

func (*Session) GetProfileParameterByQueryParams 

func (to *Session) GetProfileParameterByQueryParams(queryParams string) ([]tc.ProfileParameter, ReqInf, error)

GET a Profile Parameter by the Parameter

func (*Session) GetProfileParameters 

func (to *Session) GetProfileParameters() ([]tc.ProfileParameter, ReqInf, error)

Returns a list of Profile Parameters

func (*Session) GetProfiles 

func (to *Session) GetProfiles() ([]tc.Profile, ReqInf, error)

GetProfiles returns a list of Profiles

func (*Session) GetRegionByID 

func (to *Session) GetRegionByID(id int) ([]tc.Region, ReqInf, error)

GET a Region by the Region id

func (*Session) GetRegionByName 

func (to *Session) GetRegionByName(name string) ([]tc.Region, ReqInf, error)

GET a Region by the Region name

func (*Session) GetRegionByNamePath 

func (to *Session) GetRegionByNamePath(name string) ([]tc.RegionName, ReqInf, error)

GetRegionByNamePath gets a region by name, using the /api/version/region/name path. This gets the same data as GetRegionByName, but uses a different API path to get the same data, and returns a slightly different format.

func (*Session) GetRegions 

func (to *Session) GetRegions() ([]tc.Region, ReqInf, error)

Returns a list of regions

func (*Session) GetRoleByID 

func (to *Session) GetRoleByID(id int) ([]tc.Role, ReqInf, int, error)

GET a Role by the Role id

func (*Session) GetRoleByName 

func (to *Session) GetRoleByName(name string) ([]tc.Role, ReqInf, int, error)

GET a Role by the Role name

func (*Session) GetRoleByQueryParams 

func (to *Session) GetRoleByQueryParams(queryParams map[string]string) ([]tc.Role, ReqInf, int, error)

GetRoleByQueryParams gets a Role by the Role query parameters

func (*Session) GetRoles 

func (to *Session) GetRoles() ([]tc.Role, ReqInf, int, error)

Returns a list of roles

func (*Session) GetServerByHostName 

func (to *Session) GetServerByHostName(hostName string) ([]tc.ServerV1, ReqInf, error)

GET a Server by the Server hostname

func (*Session) GetServerByID 

func (to *Session) GetServerByID(id int) ([]tc.ServerV1, ReqInf, error)

GET a Server by the Server ID

func (*Session) GetServerCapabilities 

func (to *Session) GetServerCapabilities() ([]tc.ServerCapability, ReqInf, error)

GetServerCapabilities returns all the server capabilities.

func (*Session) GetServerCapability 

func (to *Session) GetServerCapability(name string) (*tc.ServerCapability, ReqInf, error)

GetServerCapability returns the given server capability by name.

func (*Session) GetServerDetailsByHostName 

func (to *Session) GetServerDetailsByHostName(hostName string) ([]tc.ServerDetailV11, ReqInf, error)

GetServerDetailsByHostName GETs Servers by the Server hostname.

func (*Session) GetServerFQDN 

func (to *Session) GetServerFQDN(n string) (string, ReqInf, error)

func (*Session) GetServerIDDeliveryServices 

func (to *Session) GetServerIDDeliveryServices(server int) ([]tc.DeliveryServiceNullable, ReqInf, error)

func (*Session) GetServerServerCapabilities 

func (to *Session) GetServerServerCapabilities(serverID *int, serverHostName, serverCapability *string) ([]tc.ServerServerCapability, ReqInf, error)

GetServerServerCapabilities retrieves a list of Server Capabilities that are assigned to a Server Callers can filter the results by server id, server host name and/or server capability via the optional parameters

func (*Session) GetServerStatusCounts 

func (to *Session) GetServerStatusCounts(typeName *string) (map[string]int, ReqInf, error)

GetServerStatusCounts gets the counts of each server status in Traffic Ops. If typeName is non-nil, only statuses of the given server type name will be counted.

func (*Session) GetServerUpdateStatus 

func (to *Session) GetServerUpdateStatus(hostName string) (tc.ServerUpdateStatus, ReqInf, error)

GetServerUpdateStatus GETs the Server Update Status by the Server hostname.

func (*Session) GetServers 

func (to *Session) GetServers() ([]tc.ServerV1, ReqInf, error)

Returns a list of Servers

func (*Session) GetServersByType 

func (to *Session) GetServersByType(qparams url.Values) ([]tc.ServerV1, ReqInf, error)

func (*Session) GetServersChecks 

func (to *Session) GetServersChecks() ([]tc.GenericServerCheck, tc.Alerts, ReqInf, error)

GetServersChecks fetches check and meta information about servers from /servers/checks.

func (*Session) GetServersShortNameSearch 

func (to *Session) GetServersShortNameSearch(shortname string) ([]string, ReqInf, error)

func (*Session) GetStaticDNSEntries 

func (to *Session) GetStaticDNSEntries() ([]tc.StaticDNSEntry, ReqInf, error)

Returns a list of StaticDNSEntrys

func (*Session) GetStaticDNSEntriesByHost 

func (to *Session) GetStaticDNSEntriesByHost(host string) ([]tc.StaticDNSEntry, ReqInf, error)

GET a StaticDNSEntry by the StaticDNSEntry hsot

func (*Session) GetStaticDNSEntryByID 

func (to *Session) GetStaticDNSEntryByID(id int) ([]tc.StaticDNSEntry, ReqInf, error)

GET a StaticDNSEntry by the StaticDNSEntry ID

func (*Session) GetStatusByID 

func (to *Session) GetStatusByID(id int) ([]tc.Status, ReqInf, error)

GET a Status by the Status id

func (*Session) GetStatusByName 

func (to *Session) GetStatusByName(name string) ([]tc.Status, ReqInf, error)

GET a Status by the Status name

func (*Session) GetStatuses 

func (to *Session) GetStatuses() ([]tc.Status, ReqInf, error)

Returns a list of Statuses

func (*Session) GetSteeringTargets 

func (to *Session) GetSteeringTargets(dsID int) ([]tc.SteeringTargetNullable, ReqInf, error)

func (*Session) GetSummaryStats 

func (to *Session) GetSummaryStats(cdn, deliveryService, statName *string) (tc.StatsSummaryResponse, ReqInf, error)

GetSummaryStats gets a list of summary stats with the ability to filter on cdn,deliveryService and/or stat

func (*Session) GetSummaryStatsLastUpdated 

func (to *Session) GetSummaryStatsLastUpdated(statName *string) (tc.StatsSummaryLastUpdatedResponse, ReqInf, error)

GetSummaryStatsLastUpdated time of the last summary for a given stat

func (*Session) GetTOExtensions 

func (to *Session) GetTOExtensions() (tc.TOExtensionResponse, ReqInf, error)

GetTOExtensions gets all to_extensions

func (*Session) GetTrafficMonitorConfig 

func (to *Session) GetTrafficMonitorConfig(cdn string) (*tc.LegacyTrafficMonitorConfig, ReqInf, error)

func (*Session) GetTrafficMonitorConfigMap 

func (to *Session) GetTrafficMonitorConfigMap(cdn string) (*tc.LegacyTrafficMonitorConfigMap, ReqInf, error)

func (*Session) GetTypeByID 

func (to *Session) GetTypeByID(id int) ([]tc.Type, ReqInf, error)

GET a Type by the Type ID

func (*Session) GetTypeByName 

func (to *Session) GetTypeByName(name string) ([]tc.Type, ReqInf, error)

GET a Type by the Type name

func (*Session) GetTypes 

func (to *Session) GetTypes(useInTable ...string) ([]tc.Type, ReqInf, error)

func (*Session) GetUpdate 

func (to *Session) GetUpdate(serverName string) (Update, ReqInf, error)

func (*Session) GetUserByID 

func (to *Session) GetUserByID(id int) ([]tc.User, ReqInf, error)

func (*Session) GetUserByUsername 

func (to *Session) GetUserByUsername(username string) ([]tc.User, ReqInf, error)

func (*Session) GetUserCurrent 

func (to *Session) GetUserCurrent() (*tc.UserCurrent, ReqInf, error)

GetUserCurrent gets information about the current user

func (*Session) GetUserDeliveryServices 

func (to *Session) GetUserDeliveryServices(userID int) (*tc.UserDeliveryServicesNullableResponse, ReqInf, error)

GetUserDeliveryServices gets the delivery services associated with the given user.

func (*Session) GetUsers 

func (to *Session) GetUsers() ([]tc.User, ReqInf, error)

GetUsers returns all users accessible from current user

func (*Session) GetUsersByRole 

func (to *Session) GetUsersByRole(roleName string) ([]tc.User, ReqInf, error)

GetUsersByRole returns all users accessible from current user for a given role

func (*Session) ImportProfile 

func (to *Session) ImportProfile(importRequest *tc.ProfileImportRequest) (*tc.ProfileImportResponse, ReqInf, error)

ImportProfile imports an exported Profile

func (*Session) InsertServerCheckStatus 

func (to *Session) InsertServerCheckStatus(status tc.ServercheckRequestNullable) (*tc.ServercheckPostResponse, ReqInf, error)

InsertServerCheckStatus Will insert/update the servercheck value based on if it already exists or not

func (*Session) Ping 

func (to *Session) Ping() (map[string]string, ReqInf, error)

Ping returns a static json object to show that traffic_ops is responsive

func (*Session) RawRequest 

func (to *Session) RawRequest(method, path string, body []byte) (*http.Response, net.Addr, error)

RawRequest performs the actual HTTP request to Traffic Ops, simply, without trying to refresh the cookie if an Unauthorized code is returned. Returns the response, the remote address of the Traffic Ops instance used, and any error. The returned net.Addr is guaranteed to be either nil or valid, even if the returned error is not nil. Callers are encouraged to check and use the net.Addr if an error is returned, and use the remote address in their own error messages. This violates the Go idiom that a non-nil error implies all other values are undefined, but it's more straightforward than alternatives like typecasting.

func (*Session) RegisterNewUser 

func (to *Session) RegisterNewUser(tenantID uint, roleID uint, email rfc.EmailAddress) (tc.Alerts, ReqInf, error)

RegisterNewUser requests the registration of a new user with the given tenant ID and role ID, through their email.

func (*Session) ReplaceFederationResolverMappingsForCurrentUser 

func (to *Session) ReplaceFederationResolverMappingsForCurrentUser(mappings tc.DeliveryServiceFederationResolverMappingRequest) (tc.Alerts, ReqInf, error)

ReplaceFederationResolverMappingsForCurrentUser replaces any and all Federation Resolver mappings on all Federations assigned to the currently authenticated user. This will first remove ALL Federation Resolver mappings for ALL Federations assigned to the currently authenticated user, as well as deleting ALL of the Federation Resolvers themselves. In other words, calling this is equivalent to a call to DeleteFederationResolverMappingsForCurrentUser followed by a call to AddFederationResolverMappingsForCurrentUser .

func (*Session) SetCachegroupDeliveryServices 

func (to *Session) SetCachegroupDeliveryServices(cgID int, dsIDs []int) (tc.CacheGroupPostDSRespResponse, ReqInf, error)

func (*Session) SetDeliveryServiceUser 

func (to *Session) SetDeliveryServiceUser(userID int, dses []int, replace bool) (*tc.UserDeliveryServicePostResponse, error)

SetUserDeliveryService associates the given delivery services with the given user.

func (*Session) SetServerQueueUpdate 

func (to *Session) SetServerQueueUpdate(serverID int, queueUpdate bool) (tc.ServerQueueUpdateResponse, ReqInf, error)

SetServerQueueUpdate updates a server's status and returns the response.

func (*Session) SetUpdate 

func (to *Session) SetUpdate(serverName string, updatePending int, revalPending int) (ReqInf, error)

SetUpdate sets the Update Pending and Reval Pending flags for the given cache server in Traffic Ops. This MUST only be called by an app (like ORT) which has fetched new config updates for the cache, generated or downloaded the config files onto the cache, and instructed the cache service to reload its config. This MUST NOT be called unless the cache is running the latest configuration in Traffic Ops, else the Traffic Ops cache update status will be wrong. If only the Reval or Update status has been updated, but not both, the old status should be queried from the update endpoint, and the original status for the unchanged value sent here.

func (*Session) SnapshotCRConfig 

func (to *Session) SnapshotCRConfig(cdn string) (ReqInf, error)

SnapshotCRConfig snapshots a CDN by name.

func (*Session) SnapshotCRConfigByID 

func (to *Session) SnapshotCRConfigByID(id int) (tc.Alerts, ReqInf, error)

SnapshotCDNByID snapshots a CDN by ID.

func (*Session) Steering 

func (to *Session) Steering() ([]tc.Steering, ReqInf, error)

func (*Session) Tenant 

func (to *Session) Tenant(id string) (*tc.Tenant, ReqInf, error)

Tenant gets the Tenant for the ID it's passed

func (*Session) TenantByName 

func (to *Session) TenantByName(name string) (*tc.Tenant, ReqInf, error)

TenantByName gets the Tenant for the name it's passed

func (*Session) Tenants 

func (to *Session) Tenants() ([]tc.Tenant, ReqInf, error)

Tenants gets an array of Tenants

func (*Session) UpdateASNByID 

func (to *Session) UpdateASNByID(id int, entity tc.ASN) (tc.Alerts, ReqInf, error)

Update a ASN by ID

func (*Session) UpdateCDNByID 

func (to *Session) UpdateCDNByID(id int, cdn tc.CDN) (tc.Alerts, ReqInf, error)

Update a CDN by ID

func (*Session) UpdateCDNFederationsByID 

func (to *Session) UpdateCDNFederationsByID(f tc.CDNFederation, CDNName string, ID int) (*tc.UpdateCDNFederationResponse, ReqInf, error)

func (*Session) UpdateCacheGroupNullableByID 

func (to *Session) UpdateCacheGroupNullableByID(id int, cachegroup tc.CacheGroupNullable) (*tc.CacheGroupDetailResponse, ReqInf, error)

Update a CacheGroup by ID

func (*Session) UpdateCoordinateByID 

func (to *Session) UpdateCoordinateByID(id int, coordinate tc.Coordinate) (tc.Alerts, ReqInf, error)

Update a Coordinate by ID

func (*Session) UpdateCurrentUser 

func (to *Session) UpdateCurrentUser(u tc.User) (*tc.UpdateUserResponse, ReqInf, error)

UpdateCurrentUser replaces the current user data with the provided tc.User structure.

func (*Session) UpdateDeliveryService 

func (to *Session) UpdateDeliveryService(id string, ds *tc.DeliveryService) (*tc.UpdateDeliveryServiceResponse, error)

UpdateDeliveryService updates the DeliveryService matching the ID it's passed with the DeliveryService it is passed

func (*Session) UpdateDeliveryServiceNullable 

func (to *Session) UpdateDeliveryServiceNullable(id string, ds *tc.DeliveryServiceNullable) (*tc.UpdateDeliveryServiceResponse, error)

func (*Session) UpdateDeliveryServiceRequestByID 

func (to *Session) UpdateDeliveryServiceRequestByID(id int, dsr tc.DeliveryServiceRequest) (tc.Alerts, ReqInf, error)

Update a DeliveryServiceRequest by ID

func (*Session) UpdateDeliveryServiceRequestCommentByID 

func (to *Session) UpdateDeliveryServiceRequestCommentByID(id int, comment tc.DeliveryServiceRequestComment) (tc.Alerts, ReqInf, error)

Update a delivery service request by ID

func (*Session) UpdateDeliveryServiceSafe 

func (to *Session) UpdateDeliveryServiceSafe(id int, ds tc.DeliveryServiceSafeUpdateRequest) ([]tc.DeliveryServiceNullable, ReqInf, error)

UpdateDeliveryServiceSafe updates the given Delivery Service identified by 'id' with the given "safe" fields.

func (*Session) UpdateDivisionByID 

func (to *Session) UpdateDivisionByID(id int, division tc.Division) (tc.Alerts, ReqInf, error)

Update a Division by ID

func (*Session) UpdateOriginByID 

func (to *Session) UpdateOriginByID(id int, origin tc.Origin) (*tc.OriginDetailResponse, ReqInf, error)

Update an Origin by ID

func (*Session) UpdateParameterByID 

func (to *Session) UpdateParameterByID(id int, pl tc.Parameter) (tc.Alerts, ReqInf, error)

Update a Parameter by ID

func (*Session) UpdatePhysLocationByID 

func (to *Session) UpdatePhysLocationByID(id int, pl tc.PhysLocation) (tc.Alerts, ReqInf, error)

Update a PhysLocation by ID

func (*Session) UpdateProfileByID 

func (to *Session) UpdateProfileByID(id int, pl tc.Profile) (tc.Alerts, ReqInf, error)

UpdateProfileByID updates a Profile by ID

func (*Session) UpdateRegionByID 

func (to *Session) UpdateRegionByID(id int, region tc.Region) (tc.Alerts, ReqInf, error)

Update a Region by ID

func (*Session) UpdateRoleByID 

func (to *Session) UpdateRoleByID(id int, region tc.Role) (tc.Alerts, ReqInf, int, error)

Update a Role by ID

func (*Session) UpdateServerByID 

func (to *Session) UpdateServerByID(id int, server tc.ServerV1) (tc.Alerts, ReqInf, error)

Update a Server by ID

func (*Session) UpdateServerStatus 

func (to *Session) UpdateServerStatus(serverID int, req tc.ServerPutStatus) (*tc.Alerts, ReqInf, error)

UpdateServerStatus updates a server's status and returns the response.

func (*Session) UpdateStaticDNSEntryByID 

func (to *Session) UpdateStaticDNSEntryByID(id int, sdns tc.StaticDNSEntry) (tc.Alerts, ReqInf, int, error)

Update a StaticDNSEntry by ID

func (*Session) UpdateStatusByID 

func (to *Session) UpdateStatusByID(id int, status tc.Status) (tc.Alerts, ReqInf, error)

Update a Status by ID

func (*Session) UpdateSteeringTarget 

func (to *Session) UpdateSteeringTarget(st tc.SteeringTargetNullable) (tc.Alerts, ReqInf, error)

func (*Session) UpdateTenant 

func (to *Session) UpdateTenant(id string, t *tc.Tenant) (*tc.TenantResponse, error)

UpdateTenant updates the Tenant matching the ID it's passed with the Tenant it is passed

func (*Session) UpdateTypeByID 

func (to *Session) UpdateTypeByID(id int, typ tc.Type) (tc.Alerts, ReqInf, error)

Update a Type by ID

func (*Session) UpdateUserByID 

func (to *Session) UpdateUserByID(id int, u *tc.User) (*tc.UpdateUserResponse, ReqInf, error)

UpdateUserByID updates user with the given id

func (*Session) Users 

func (to *Session) Users() ([]tc.User, error)

Users gets an array of Users. Deprecated: use GetUsers

type Update 

type Update struct {
	UpdatePending      bool   `json:"upd_pending"`
	ParentPending      bool   `json:"parent_pending"`
	RevalPending       bool   `json:"reval_pending"`
	ParentRevalPending bool   `json:"parent_reval_pending"`
	Status             string `json:"status"`
	HostID             int    `json:"host_id"`
	HostName           string `json:"host_name"`
}

type UpdateResponse 

type UpdateResponse []Update

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.