swarming

package
v0.0.0-...-65c0a2b Latest Latest
Warning

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

Go to latest
Published: Feb 19, 2025 License: Apache-2.0 Imports: 17 Imported by: 46

Documentation

Overview

Package swarming provides access to the .

Library status

These client libraries are officially supported by Google. However, this library is considered complete and is in maintenance mode. This means that we will address critical bugs and security issues but will not add any new features.

When possible, we recommend using our newer [Cloud Client Libraries for Go](https://pkg.go.dev/cloud.google.com/go) that are still actively being worked and iterated on.

Creating a client

Usage example:

import "go.chromium.org/luci/common/api/swarming/swarming/v1"
...
ctx := context.Background()
swarmingService, err := swarming.NewService(ctx)

In this example, Google Application Default Credentials are used for authentication. For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.

Other authentication options

To use an API key for authentication (note: some APIs do not support API keys), use google.golang.org/api/option.WithAPIKey:

swarmingService, err := swarming.NewService(ctx, option.WithAPIKey("AIza..."))

To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow, use google.golang.org/api/option.WithTokenSource:

config := &oauth2.Config{...}
// ...
token, err := config.Exchange(ctx, ...)
swarmingService, err := swarming.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))

See google.golang.org/api/option.ClientOption for details on options.

Index

Constants

View Source
const (
	// https://www.googleapis.com/auth/userinfo.email
	UserinfoEmailScope = "https://www.googleapis.com/auth/userinfo.email"
)

OAuth2 scopes used by this API.

Variables

This section is empty.

Functions

This section is empty.

Types

type BotDeleteCall

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

func (*BotDeleteCall) Context

func (c *BotDeleteCall) Context(ctx context.Context) *BotDeleteCall

Context sets the context to be used in this call's Do method.

func (*BotDeleteCall) Do

Do executes the "swarming.bot.delete" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsDeletedResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*BotDeleteCall) Fields

func (c *BotDeleteCall) Fields(s ...googleapi.Field) *BotDeleteCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*BotDeleteCall) Header

func (c *BotDeleteCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type BotEventsCall

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

func (*BotEventsCall) Context

func (c *BotEventsCall) Context(ctx context.Context) *BotEventsCall

Context sets the context to be used in this call's Do method.

func (*BotEventsCall) Cursor

func (c *BotEventsCall) Cursor(cursor string) *BotEventsCall

Cursor sets the optional parameter "cursor":

func (*BotEventsCall) Do

Do executes the "swarming.bot.events" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsBotEvents.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*BotEventsCall) End

func (c *BotEventsCall) End(end float64) *BotEventsCall

End sets the optional parameter "end":

func (*BotEventsCall) Fields

func (c *BotEventsCall) Fields(s ...googleapi.Field) *BotEventsCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*BotEventsCall) Header

func (c *BotEventsCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*BotEventsCall) IfNoneMatch

func (c *BotEventsCall) IfNoneMatch(entityTag string) *BotEventsCall

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

func (*BotEventsCall) Limit

func (c *BotEventsCall) Limit(limit int64) *BotEventsCall

Limit sets the optional parameter "limit":

func (*BotEventsCall) Start

func (c *BotEventsCall) Start(start float64) *BotEventsCall

Start sets the optional parameter "start":

type BotGetCall

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

func (*BotGetCall) Context

func (c *BotGetCall) Context(ctx context.Context) *BotGetCall

Context sets the context to be used in this call's Do method.

func (*BotGetCall) Do

Do executes the "swarming.bot.get" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsBotInfo.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*BotGetCall) Fields

func (c *BotGetCall) Fields(s ...googleapi.Field) *BotGetCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*BotGetCall) Header

func (c *BotGetCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*BotGetCall) IfNoneMatch

func (c *BotGetCall) IfNoneMatch(entityTag string) *BotGetCall

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

type BotService

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

func NewBotService

func NewBotService(s *Service) *BotService

func (*BotService) Delete

func (r *BotService) Delete(botId string) *BotDeleteCall

Delete: Deletes the bot corresponding to a provided bot_id. At that point, the bot will not appears in the list of bots but it is still possible to get information about the bot with its bot id is known, as historical data is not deleted. It is meant to remove from the DB the presence of a bot that was retired, e.g. the VM was shut down already. Use 'terminate' instead of the bot is still alive.

- botId: .

func (*BotService) Events

func (r *BotService) Events(botId string) *BotEventsCall

Events: Returns events that happened on a bot.

- botId: .

func (*BotService) Get

func (r *BotService) Get(botId string) *BotGetCall

Get: Returns information about a known bot. This includes its state and dimensions, and if it is currently running a task.

- botId: .

func (*BotService) Tasks

func (r *BotService) Tasks(botId string) *BotTasksCall

Tasks: Lists a given bot's tasks within the specified date range. In this case, the tasks are effectively TaskRunResult since it's individual task tries sent to this specific bot. It is impossible to search by both tags and bot id. If there's a need, TaskRunResult.tags will be added (via a copy from TaskRequest.tags).

- botId: .

func (*BotService) Terminate

func (r *BotService) Terminate(botId string) *BotTerminateCall

Terminate: Asks a bot to terminate itself gracefully. The bot will stay in the DB, use 'delete' to remove it from the DB afterward. This request returns a pseudo-taskid that can be waited for to wait for the bot to turn down. This command is particularly useful when a privileged user needs to safely debug a machine specific issue. The user can trigger a terminate for one of the bot exhibiting the issue, wait for the pseudo-task to run then access the machine with the guarantee that the bot is not running anymore.

- botId: .

type BotTasksCall

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

func (*BotTasksCall) Context

func (c *BotTasksCall) Context(ctx context.Context) *BotTasksCall

Context sets the context to be used in this call's Do method.

func (*BotTasksCall) Cursor

func (c *BotTasksCall) Cursor(cursor string) *BotTasksCall

Cursor sets the optional parameter "cursor":

func (*BotTasksCall) Do

Do executes the "swarming.bot.tasks" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsBotTasks.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*BotTasksCall) End

func (c *BotTasksCall) End(end float64) *BotTasksCall

End sets the optional parameter "end":

func (*BotTasksCall) Fields

func (c *BotTasksCall) Fields(s ...googleapi.Field) *BotTasksCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*BotTasksCall) Header

func (c *BotTasksCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*BotTasksCall) IfNoneMatch

func (c *BotTasksCall) IfNoneMatch(entityTag string) *BotTasksCall

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

func (*BotTasksCall) IncludePerformanceStats

func (c *BotTasksCall) IncludePerformanceStats(includePerformanceStats bool) *BotTasksCall

IncludePerformanceStats sets the optional parameter "include_performance_stats":

func (*BotTasksCall) Limit

func (c *BotTasksCall) Limit(limit int64) *BotTasksCall

Limit sets the optional parameter "limit":

func (*BotTasksCall) Sort

func (c *BotTasksCall) Sort(sort string) *BotTasksCall

Sort sets the optional parameter "sort":

Possible values:

"ABANDONED_TS"
"COMPLETED_TS"
"CREATED_TS" (default)
"STARTED_TS"

func (*BotTasksCall) Start

func (c *BotTasksCall) Start(start float64) *BotTasksCall

Start sets the optional parameter "start":

func (*BotTasksCall) State

func (c *BotTasksCall) State(state string) *BotTasksCall

State sets the optional parameter "state":

Possible values:

"ALL" (default)
"BOT_DIED"
"CANCELED"
"CLIENT_ERROR"
"COMPLETED"
"COMPLETED_FAILURE"
"COMPLETED_SUCCESS"
"DEDUPED"
"EXPIRED"
"KILLED"
"NO_RESOURCE"
"PENDING"
"PENDING_RUNNING"
"RUNNING"
"TIMED_OUT"

type BotTerminateCall

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

func (*BotTerminateCall) Context

Context sets the context to be used in this call's Do method.

func (*BotTerminateCall) Do

Do executes the "swarming.bot.terminate" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsTerminateResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*BotTerminateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*BotTerminateCall) Header

func (c *BotTerminateCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type BotsCountCall

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

func (*BotsCountCall) Context

func (c *BotsCountCall) Context(ctx context.Context) *BotsCountCall

Context sets the context to be used in this call's Do method.

func (*BotsCountCall) Dimensions

func (c *BotsCountCall) Dimensions(dimensions ...string) *BotsCountCall

Dimensions sets the optional parameter "dimensions":

func (*BotsCountCall) Do

Do executes the "swarming.bots.count" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsBotsCount.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*BotsCountCall) Fields

func (c *BotsCountCall) Fields(s ...googleapi.Field) *BotsCountCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*BotsCountCall) Header

func (c *BotsCountCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*BotsCountCall) IfNoneMatch

func (c *BotsCountCall) IfNoneMatch(entityTag string) *BotsCountCall

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

type BotsDimensionsCall

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

func (*BotsDimensionsCall) Context

Context sets the context to be used in this call's Do method.

func (*BotsDimensionsCall) Do

Do executes the "swarming.bots.dimensions" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsBotsDimensions.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*BotsDimensionsCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*BotsDimensionsCall) Header

func (c *BotsDimensionsCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*BotsDimensionsCall) IfNoneMatch

func (c *BotsDimensionsCall) IfNoneMatch(entityTag string) *BotsDimensionsCall

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

func (*BotsDimensionsCall) Pool

Pool sets the optional parameter "pool":

type BotsListCall

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

func (*BotsListCall) Context

func (c *BotsListCall) Context(ctx context.Context) *BotsListCall

Context sets the context to be used in this call's Do method.

func (*BotsListCall) Cursor

func (c *BotsListCall) Cursor(cursor string) *BotsListCall

Cursor sets the optional parameter "cursor":

func (*BotsListCall) Dimensions

func (c *BotsListCall) Dimensions(dimensions ...string) *BotsListCall

Dimensions sets the optional parameter "dimensions":

func (*BotsListCall) Do

Do executes the "swarming.bots.list" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsBotList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*BotsListCall) Fields

func (c *BotsListCall) Fields(s ...googleapi.Field) *BotsListCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*BotsListCall) Header

func (c *BotsListCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*BotsListCall) IfNoneMatch

func (c *BotsListCall) IfNoneMatch(entityTag string) *BotsListCall

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

func (*BotsListCall) InMaintenance

func (c *BotsListCall) InMaintenance(inMaintenance string) *BotsListCall

InMaintenance sets the optional parameter "in_maintenance":

Possible values:

"FALSE"
"NONE" (default)
"TRUE"

func (*BotsListCall) IsBusy

func (c *BotsListCall) IsBusy(isBusy string) *BotsListCall

IsBusy sets the optional parameter "is_busy":

Possible values:

"FALSE"
"NONE" (default)
"TRUE"

func (*BotsListCall) IsDead

func (c *BotsListCall) IsDead(isDead string) *BotsListCall

IsDead sets the optional parameter "is_dead":

Possible values:

"FALSE"
"NONE" (default)
"TRUE"

func (*BotsListCall) Limit

func (c *BotsListCall) Limit(limit int64) *BotsListCall

Limit sets the optional parameter "limit":

func (*BotsListCall) Quarantined

func (c *BotsListCall) Quarantined(quarantined string) *BotsListCall

Quarantined sets the optional parameter "quarantined":

Possible values:

"FALSE"
"NONE" (default)
"TRUE"

type BotsService

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

func NewBotsService

func NewBotsService(s *Service) *BotsService

func (*BotsService) Count

func (r *BotsService) Count() *BotsCountCall

Count: Counts number of bots with given dimensions.

func (*BotsService) Dimensions

func (r *BotsService) Dimensions() *BotsDimensionsCall

Dimensions: Returns the cached set of dimensions currently in use in the fleet.

func (*BotsService) List

func (r *BotsService) List() *BotsListCall

List: Provides list of known bots. Deleted bots will not be listed.

type QueuesListCall

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

func (*QueuesListCall) Context

func (c *QueuesListCall) Context(ctx context.Context) *QueuesListCall

Context sets the context to be used in this call's Do method.

func (*QueuesListCall) Cursor

func (c *QueuesListCall) Cursor(cursor string) *QueuesListCall

Cursor sets the optional parameter "cursor":

func (*QueuesListCall) Do

Do executes the "swarming.queues.list" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsTaskQueueList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*QueuesListCall) Fields

func (c *QueuesListCall) Fields(s ...googleapi.Field) *QueuesListCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*QueuesListCall) Header

func (c *QueuesListCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*QueuesListCall) IfNoneMatch

func (c *QueuesListCall) IfNoneMatch(entityTag string) *QueuesListCall

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

func (*QueuesListCall) Limit

func (c *QueuesListCall) Limit(limit int64) *QueuesListCall

Limit sets the optional parameter "limit":

type QueuesService

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

func NewQueuesService

func NewQueuesService(s *Service) *QueuesService

func (*QueuesService) List

func (r *QueuesService) List() *QueuesListCall

List:

type ServerDetailsCall

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

func (*ServerDetailsCall) Context

Context sets the context to be used in this call's Do method.

func (*ServerDetailsCall) Do

Do executes the "swarming.server.details" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsServerDetails.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ServerDetailsCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*ServerDetailsCall) Header

func (c *ServerDetailsCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*ServerDetailsCall) IfNoneMatch

func (c *ServerDetailsCall) IfNoneMatch(entityTag string) *ServerDetailsCall

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

type ServerGetBootstrapCall

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

func (*ServerGetBootstrapCall) Context

Context sets the context to be used in this call's Do method.

func (*ServerGetBootstrapCall) Do

Do executes the "swarming.server.get_bootstrap" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsFileContent.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ServerGetBootstrapCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*ServerGetBootstrapCall) Header

func (c *ServerGetBootstrapCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*ServerGetBootstrapCall) IfNoneMatch

func (c *ServerGetBootstrapCall) IfNoneMatch(entityTag string) *ServerGetBootstrapCall

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

type ServerGetBotConfigCall

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

func (*ServerGetBotConfigCall) Context

Context sets the context to be used in this call's Do method.

func (*ServerGetBotConfigCall) Do

Do executes the "swarming.server.get_bot_config" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsFileContent.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ServerGetBotConfigCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*ServerGetBotConfigCall) Header

func (c *ServerGetBotConfigCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*ServerGetBotConfigCall) IfNoneMatch

func (c *ServerGetBotConfigCall) IfNoneMatch(entityTag string) *ServerGetBotConfigCall

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

type ServerPermissionsCall

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

func (*ServerPermissionsCall) BotId

BotId sets the optional parameter "bot_id":

func (*ServerPermissionsCall) Context

Context sets the context to be used in this call's Do method.

func (*ServerPermissionsCall) Do

Do executes the "swarming.server.permissions" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsClientPermissions.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ServerPermissionsCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*ServerPermissionsCall) Header

func (c *ServerPermissionsCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*ServerPermissionsCall) IfNoneMatch

func (c *ServerPermissionsCall) IfNoneMatch(entityTag string) *ServerPermissionsCall

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

func (*ServerPermissionsCall) Tags

Tags sets the optional parameter "tags":

func (*ServerPermissionsCall) TaskId

TaskId sets the optional parameter "task_id":

type ServerService

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

func NewServerService

func NewServerService(s *Service) *ServerService

func (*ServerService) Details

func (r *ServerService) Details() *ServerDetailsCall

Details: Returns information about the server.

func (*ServerService) GetBootstrap

func (r *ServerService) GetBootstrap() *ServerGetBootstrapCall

GetBootstrap: Retrieves the current version of bootstrap.py.

func (*ServerService) GetBotConfig

func (r *ServerService) GetBotConfig() *ServerGetBotConfigCall

GetBotConfig: Retrieves the current version of bot_config.py.

func (*ServerService) Permissions

func (r *ServerService) Permissions() *ServerPermissionsCall

Permissions: Returns the caller's permissions.

func (*ServerService) Token

func (r *ServerService) Token() *ServerTokenCall

Token: Returns a token to bootstrap a new bot. This may seem strange to be a POST and not a GET, but it's very important to make sure GET requests are idempotent and safe to be pre-fetched; generating a token is neither of those things.

type ServerTokenCall

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

func (*ServerTokenCall) Context

Context sets the context to be used in this call's Do method.

func (*ServerTokenCall) Do

Do executes the "swarming.server.token" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsBootstrapToken.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ServerTokenCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*ServerTokenCall) Header

func (c *ServerTokenCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type Service

type Service struct {
	BasePath  string // API endpoint base URL
	UserAgent string // optional additional User-Agent fragment

	Bot *BotService

	Bots *BotsService

	Queues *QueuesService

	Server *ServerService

	Task *TaskService

	Tasks *TasksService
	// contains filtered or unexported fields
}

func New deprecated

func New(client *http.Client) (*Service, error)

New creates a new Service. It uses the provided http.Client for requests.

Deprecated: please use NewService instead. To provide a custom HTTP client, use option.WithHTTPClient. If you are using google.golang.org/api/googleapis/transport.APIKey, use option.WithAPIKey with NewService instead.

func NewService

func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error)

NewService creates a new Service.

type SwarmingRpcsBootstrapToken

type SwarmingRpcsBootstrapToken struct {
	BootstrapToken string `json:"bootstrap_token,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "BootstrapToken") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "BootstrapToken") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsBootstrapToken: Returns a token to bootstrap a new bot.

func (SwarmingRpcsBootstrapToken) MarshalJSON

func (s SwarmingRpcsBootstrapToken) MarshalJSON() ([]byte, error)

type SwarmingRpcsBotEvent

type SwarmingRpcsBotEvent struct {
	AuthenticatedAs string `json:"authenticated_as,omitempty"`
	// Dimensions: Represents a mapping of string to list of strings.
	Dimensions     []*SwarmingRpcsStringListPair `json:"dimensions,omitempty"`
	EventType      string                        `json:"event_type,omitempty"`
	ExternalIp     string                        `json:"external_ip,omitempty"`
	MaintenanceMsg string                        `json:"maintenance_msg,omitempty"`
	Message        string                        `json:"message,omitempty"`
	Quarantined    bool                          `json:"quarantined,omitempty"`
	State          string                        `json:"state,omitempty"`
	TaskId         string                        `json:"task_id,omitempty"`
	Ts             string                        `json:"ts,omitempty"`
	Version        string                        `json:"version,omitempty"`
	// ForceSendFields is a list of field names (e.g. "AuthenticatedAs") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "AuthenticatedAs") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (SwarmingRpcsBotEvent) MarshalJSON

func (s SwarmingRpcsBotEvent) MarshalJSON() ([]byte, error)

type SwarmingRpcsBotEvents

type SwarmingRpcsBotEvents struct {
	Cursor string                  `json:"cursor,omitempty"`
	Items  []*SwarmingRpcsBotEvent `json:"items,omitempty"`
	Now    string                  `json:"now,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Cursor") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Cursor") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (SwarmingRpcsBotEvents) MarshalJSON

func (s SwarmingRpcsBotEvents) MarshalJSON() ([]byte, error)

type SwarmingRpcsBotInfo

type SwarmingRpcsBotInfo struct {
	AuthenticatedAs string `json:"authenticated_as,omitempty"`
	BotId           string `json:"bot_id,omitempty"`
	Deleted         bool   `json:"deleted,omitempty"`
	// Dimensions: Represents a mapping of string to list of strings.
	Dimensions         []*SwarmingRpcsStringListPair `json:"dimensions,omitempty"`
	ExternalIp         string                        `json:"external_ip,omitempty"`
	FirstSeenTs        string                        `json:"first_seen_ts,omitempty"`
	IsDead             bool                          `json:"is_dead,omitempty"`
	LastSeenTs         string                        `json:"last_seen_ts,omitempty"`
	LeaseExpirationTs  string                        `json:"lease_expiration_ts,omitempty"`
	LeaseId            string                        `json:"lease_id,omitempty"`
	LeasedIndefinitely bool                          `json:"leased_indefinitely,omitempty"`
	MachineLease       string                        `json:"machine_lease,omitempty"`
	MachineType        string                        `json:"machine_type,omitempty"`
	MaintenanceMsg     string                        `json:"maintenance_msg,omitempty"`
	Quarantined        bool                          `json:"quarantined,omitempty"`
	State              string                        `json:"state,omitempty"`
	TaskId             string                        `json:"task_id,omitempty"`
	TaskName           string                        `json:"task_name,omitempty"`
	Version            string                        `json:"version,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "AuthenticatedAs") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "AuthenticatedAs") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsBotInfo: Representation of the BotInfo ndb model.

func (SwarmingRpcsBotInfo) MarshalJSON

func (s SwarmingRpcsBotInfo) MarshalJSON() ([]byte, error)

type SwarmingRpcsBotList

type SwarmingRpcsBotList struct {
	Cursor       string `json:"cursor,omitempty"`
	DeathTimeout int64  `json:"death_timeout,omitempty,string"`
	// Items: Representation of the BotInfo ndb model.
	Items []*SwarmingRpcsBotInfo `json:"items,omitempty"`
	Now   string                 `json:"now,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Cursor") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Cursor") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsBotList: Wraps a list of BotInfo.

func (SwarmingRpcsBotList) MarshalJSON

func (s SwarmingRpcsBotList) MarshalJSON() ([]byte, error)

type SwarmingRpcsBotTasks

type SwarmingRpcsBotTasks struct {
	Cursor string `json:"cursor,omitempty"`
	// Items: Representation of the TaskResultSummary or TaskRunResult ndb model.
	Items []*SwarmingRpcsTaskResult `json:"items,omitempty"`
	Now   string                    `json:"now,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Cursor") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Cursor") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (SwarmingRpcsBotTasks) MarshalJSON

func (s SwarmingRpcsBotTasks) MarshalJSON() ([]byte, error)

type SwarmingRpcsBotsCount

type SwarmingRpcsBotsCount struct {
	Busy        int64  `json:"busy,omitempty,string"`
	Count       int64  `json:"count,omitempty,string"`
	Dead        int64  `json:"dead,omitempty,string"`
	Maintenance int64  `json:"maintenance,omitempty,string"`
	Now         string `json:"now,omitempty"`
	Quarantined int64  `json:"quarantined,omitempty,string"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Busy") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Busy") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsBotsCount: Returns the count, as requested.

func (SwarmingRpcsBotsCount) MarshalJSON

func (s SwarmingRpcsBotsCount) MarshalJSON() ([]byte, error)

type SwarmingRpcsBotsDimensions

type SwarmingRpcsBotsDimensions struct {
	// BotsDimensions: Represents a mapping of string to list of strings.
	BotsDimensions []*SwarmingRpcsStringListPair `json:"bots_dimensions,omitempty"`
	Ts             string                        `json:"ts,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "BotsDimensions") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "BotsDimensions") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsBotsDimensions: Returns all the dimensions and dimension possibilities in the fleet.

func (SwarmingRpcsBotsDimensions) MarshalJSON

func (s SwarmingRpcsBotsDimensions) MarshalJSON() ([]byte, error)

type SwarmingRpcsCASOperationStats

type SwarmingRpcsCASOperationStats struct {
	Duration            float64 `json:"duration,omitempty"`
	InitialNumberItems  int64   `json:"initial_number_items,omitempty,string"`
	InitialSize         int64   `json:"initial_size,omitempty,string"`
	ItemsCold           string  `json:"items_cold,omitempty"`
	ItemsHot            string  `json:"items_hot,omitempty"`
	NumItemsCold        int64   `json:"num_items_cold,omitempty,string"`
	NumItemsHot         int64   `json:"num_items_hot,omitempty,string"`
	TotalBytesItemsCold int64   `json:"total_bytes_items_cold,omitempty,string"`
	TotalBytesItemsHot  int64   `json:"total_bytes_items_hot,omitempty,string"`
	// ForceSendFields is a list of field names (e.g. "Duration") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Duration") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (SwarmingRpcsCASOperationStats) MarshalJSON

func (s SwarmingRpcsCASOperationStats) MarshalJSON() ([]byte, error)

func (*SwarmingRpcsCASOperationStats) UnmarshalJSON

func (s *SwarmingRpcsCASOperationStats) UnmarshalJSON(data []byte) error

type SwarmingRpcsCASReference

type SwarmingRpcsCASReference struct {
	CasInstance string              `json:"cas_instance,omitempty"`
	Digest      *SwarmingRpcsDigest `json:"digest,omitempty"`
	// ForceSendFields is a list of field names (e.g. "CasInstance") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "CasInstance") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (SwarmingRpcsCASReference) MarshalJSON

func (s SwarmingRpcsCASReference) MarshalJSON() ([]byte, error)

type SwarmingRpcsCacheEntry

type SwarmingRpcsCacheEntry struct {
	Name string `json:"name,omitempty"`
	Path string `json:"path,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Name") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Name") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsCacheEntry: Describes a named cache that should be present on the bot. A CacheEntry in a task specified that the task prefers the cache to be present on the bot. A symlink to the cache directory is created at <run_dir>/|path|. If cache is not present on the machine, the directory is empty. If the tasks makes any changes to the contents of the cache directory, they are persisted on the machine. If another task runs on the same machine and requests the same named cache, even if mapped to a different path, it will see the changes.

func (SwarmingRpcsCacheEntry) MarshalJSON

func (s SwarmingRpcsCacheEntry) MarshalJSON() ([]byte, error)

type SwarmingRpcsCancelResponse

type SwarmingRpcsCancelResponse struct {
	Ok         bool `json:"ok,omitempty"`
	WasRunning bool `json:"was_running,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Ok") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Ok") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsCancelResponse: Result of a request to cancel a task.

func (SwarmingRpcsCancelResponse) MarshalJSON

func (s SwarmingRpcsCancelResponse) MarshalJSON() ([]byte, error)

type SwarmingRpcsCipdInput

type SwarmingRpcsCipdInput struct {
	// ClientPackage: A CIPD package to install in the run dir before task
	// execution.
	ClientPackage *SwarmingRpcsCipdPackage `json:"client_package,omitempty"`
	// Packages: A CIPD package to install in the run dir before task execution.
	Packages []*SwarmingRpcsCipdPackage `json:"packages,omitempty"`
	Server   string                     `json:"server,omitempty"`
	// ForceSendFields is a list of field names (e.g. "ClientPackage") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "ClientPackage") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsCipdInput: Defines CIPD packages to install in task run directory.

func (SwarmingRpcsCipdInput) MarshalJSON

func (s SwarmingRpcsCipdInput) MarshalJSON() ([]byte, error)

type SwarmingRpcsCipdPackage

type SwarmingRpcsCipdPackage struct {
	PackageName string `json:"package_name,omitempty"`
	Path        string `json:"path,omitempty"`
	Version     string `json:"version,omitempty"`
	// ForceSendFields is a list of field names (e.g. "PackageName") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "PackageName") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsCipdPackage: A CIPD package to install in the run dir before task execution.

func (SwarmingRpcsCipdPackage) MarshalJSON

func (s SwarmingRpcsCipdPackage) MarshalJSON() ([]byte, error)

type SwarmingRpcsCipdPins

type SwarmingRpcsCipdPins struct {
	// ClientPackage: A CIPD package to install in the run dir before task
	// execution.
	ClientPackage *SwarmingRpcsCipdPackage `json:"client_package,omitempty"`
	// Packages: A CIPD package to install in the run dir before task execution.
	Packages []*SwarmingRpcsCipdPackage `json:"packages,omitempty"`
	// ForceSendFields is a list of field names (e.g. "ClientPackage") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "ClientPackage") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsCipdPins: Defines pinned CIPD packages that were installed during the task.

func (SwarmingRpcsCipdPins) MarshalJSON

func (s SwarmingRpcsCipdPins) MarshalJSON() ([]byte, error)

type SwarmingRpcsClientPermissions

type SwarmingRpcsClientPermissions struct {
	CancelTask        bool     `json:"cancel_task,omitempty"`
	CancelTasks       bool     `json:"cancel_tasks,omitempty"`
	DeleteBot         bool     `json:"delete_bot,omitempty"`
	DeleteBots        bool     `json:"delete_bots,omitempty"`
	GetBootstrapToken bool     `json:"get_bootstrap_token,omitempty"`
	GetConfigs        bool     `json:"get_configs,omitempty"`
	ListBots          []string `json:"list_bots,omitempty"`
	ListTasks         []string `json:"list_tasks,omitempty"`
	PutConfigs        bool     `json:"put_configs,omitempty"`
	TerminateBot      bool     `json:"terminate_bot,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "CancelTask") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "CancelTask") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsClientPermissions: Reports the client's permissions.

func (SwarmingRpcsClientPermissions) MarshalJSON

func (s SwarmingRpcsClientPermissions) MarshalJSON() ([]byte, error)

type SwarmingRpcsContainment

type SwarmingRpcsContainment struct {
	// Possible values:
	//   "AUTO"
	//   "JOB_OBJECT"
	//   "NONE"
	//   "NOT_SPECIFIED"
	ContainmentType string `json:"containment_type,omitempty"`
	// ForceSendFields is a list of field names (e.g. "ContainmentType") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "ContainmentType") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsContainment: See proto/api/swarming.proto for description.

func (SwarmingRpcsContainment) MarshalJSON

func (s SwarmingRpcsContainment) MarshalJSON() ([]byte, error)

type SwarmingRpcsDeletedResponse

type SwarmingRpcsDeletedResponse struct {
	Deleted bool `json:"deleted,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Deleted") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Deleted") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsDeletedResponse: Indicates whether a bot was deleted.

func (SwarmingRpcsDeletedResponse) MarshalJSON

func (s SwarmingRpcsDeletedResponse) MarshalJSON() ([]byte, error)

type SwarmingRpcsDigest

type SwarmingRpcsDigest struct {
	Hash      string `json:"hash,omitempty"`
	SizeBytes int64  `json:"size_bytes,omitempty,string"`
	// ForceSendFields is a list of field names (e.g. "Hash") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Hash") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (SwarmingRpcsDigest) MarshalJSON

func (s SwarmingRpcsDigest) MarshalJSON() ([]byte, error)

type SwarmingRpcsFileContent

type SwarmingRpcsFileContent struct {
	Content string `json:"content,omitempty"`
	Version string `json:"version,omitempty"`
	When    string `json:"when,omitempty"`
	Who     string `json:"who,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Content") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Content") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsFileContent: Content of a file.

func (SwarmingRpcsFileContent) MarshalJSON

func (s SwarmingRpcsFileContent) MarshalJSON() ([]byte, error)

type SwarmingRpcsNewTaskRequest

type SwarmingRpcsNewTaskRequest struct {
	BotPingToleranceSecs int64  `json:"bot_ping_tolerance_secs,omitempty,string"`
	EvaluateOnly         bool   `json:"evaluate_only,omitempty"`
	ExpirationSecs       int64  `json:"expiration_secs,omitempty,string"`
	Name                 string `json:"name,omitempty"`
	ParentTaskId         string `json:"parent_task_id,omitempty"`
	// Possible values:
	//   "AUTO" (default)
	//   "CANARY_NEVER"
	//   "CANARY_PREFER"
	//   "SKIP"
	PoolTaskTemplate string `json:"pool_task_template,omitempty"`
	Priority         int64  `json:"priority,omitempty,string"`
	// Properties: Important metadata about a particular task.
	Properties      *SwarmingRpcsTaskProperties `json:"properties,omitempty"`
	PubsubAuthToken string                      `json:"pubsub_auth_token,omitempty"`
	PubsubTopic     string                      `json:"pubsub_topic,omitempty"`
	PubsubUserdata  string                      `json:"pubsub_userdata,omitempty"`
	Realm           string                      `json:"realm,omitempty"`
	RequestUuid     string                      `json:"request_uuid,omitempty"`
	// Resultdb: Swarming:ResultDB integration configuration for a task. See
	// NewTaskRequest.resultdb for more details.
	Resultdb       *SwarmingRpcsResultDBCfg `json:"resultdb,omitempty"`
	ServiceAccount string                   `json:"service_account,omitempty"`
	Tags           []string                 `json:"tags,omitempty"`
	// TaskSlices: Defines a possible task execution for a task request to be run
	// on the Swarming infrastructure. This is one of the possible fallback on a
	// task request.
	TaskSlices []*SwarmingRpcsTaskSlice `json:"task_slices,omitempty"`
	User       string                   `json:"user,omitempty"`
	// ForceSendFields is a list of field names (e.g. "BotPingToleranceSecs") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "BotPingToleranceSecs") to include
	// in API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsNewTaskRequest: Description of a new task request as described by the client. This message is used to create a new task.

func (SwarmingRpcsNewTaskRequest) MarshalJSON

func (s SwarmingRpcsNewTaskRequest) MarshalJSON() ([]byte, error)

type SwarmingRpcsOperationStats

type SwarmingRpcsOperationStats struct {
	Duration float64 `json:"duration,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Duration") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Duration") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (SwarmingRpcsOperationStats) MarshalJSON

func (s SwarmingRpcsOperationStats) MarshalJSON() ([]byte, error)

func (*SwarmingRpcsOperationStats) UnmarshalJSON

func (s *SwarmingRpcsOperationStats) UnmarshalJSON(data []byte) error

type SwarmingRpcsPerformanceStats

type SwarmingRpcsPerformanceStats struct {
	BotOverhead          float64                        `json:"bot_overhead,omitempty"`
	CacheTrim            *SwarmingRpcsOperationStats    `json:"cache_trim,omitempty"`
	Cleanup              *SwarmingRpcsOperationStats    `json:"cleanup,omitempty"`
	IsolatedDownload     *SwarmingRpcsCASOperationStats `json:"isolated_download,omitempty"`
	IsolatedUpload       *SwarmingRpcsCASOperationStats `json:"isolated_upload,omitempty"`
	NamedCachesInstall   *SwarmingRpcsOperationStats    `json:"named_caches_install,omitempty"`
	NamedCachesUninstall *SwarmingRpcsOperationStats    `json:"named_caches_uninstall,omitempty"`
	PackageInstallation  *SwarmingRpcsOperationStats    `json:"package_installation,omitempty"`
	// ForceSendFields is a list of field names (e.g. "BotOverhead") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "BotOverhead") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsPerformanceStats: Performance stats of task execution. See task_result.PerformanceStats for details.

func (SwarmingRpcsPerformanceStats) MarshalJSON

func (s SwarmingRpcsPerformanceStats) MarshalJSON() ([]byte, error)

func (*SwarmingRpcsPerformanceStats) UnmarshalJSON

func (s *SwarmingRpcsPerformanceStats) UnmarshalJSON(data []byte) error

type SwarmingRpcsResultDBCfg

type SwarmingRpcsResultDBCfg struct {
	Enable bool `json:"enable,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Enable") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Enable") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsResultDBCfg: Swarming:ResultDB integration configuration for a task. See NewTaskRequest.resultdb for more details.

func (SwarmingRpcsResultDBCfg) MarshalJSON

func (s SwarmingRpcsResultDBCfg) MarshalJSON() ([]byte, error)

type SwarmingRpcsResultDBInfo

type SwarmingRpcsResultDBInfo struct {
	Hostname   string `json:"hostname,omitempty"`
	Invocation string `json:"invocation,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Hostname") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Hostname") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsResultDBInfo: ResultDB related properties.

func (SwarmingRpcsResultDBInfo) MarshalJSON

func (s SwarmingRpcsResultDBInfo) MarshalJSON() ([]byte, error)

type SwarmingRpcsServerDetails

type SwarmingRpcsServerDetails struct {
	BotVersion               string `json:"bot_version,omitempty"`
	CasViewerServer          string `json:"cas_viewer_server,omitempty"`
	DisplayServerUrlTemplate string `json:"display_server_url_template,omitempty"`
	LuciConfig               string `json:"luci_config,omitempty"`
	MachineProviderTemplate  string `json:"machine_provider_template,omitempty"`
	ServerVersion            string `json:"server_version,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "BotVersion") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "BotVersion") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsServerDetails: Reports details about the server.

func (SwarmingRpcsServerDetails) MarshalJSON

func (s SwarmingRpcsServerDetails) MarshalJSON() ([]byte, error)

type SwarmingRpcsStringListPair

type SwarmingRpcsStringListPair struct {
	Key   string   `json:"key,omitempty"`
	Value []string `json:"value,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Key") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Key") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsStringListPair: Represents a mapping of string to list of strings.

func (SwarmingRpcsStringListPair) MarshalJSON

func (s SwarmingRpcsStringListPair) MarshalJSON() ([]byte, error)

type SwarmingRpcsStringPair

type SwarmingRpcsStringPair struct {
	Key   string `json:"key,omitempty"`
	Value string `json:"value,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Key") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Key") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsStringPair: Represents a mapping of string to string.

func (SwarmingRpcsStringPair) MarshalJSON

func (s SwarmingRpcsStringPair) MarshalJSON() ([]byte, error)

type SwarmingRpcsTaskCancelRequest

type SwarmingRpcsTaskCancelRequest struct {
	KillRunning bool `json:"kill_running,omitempty"`
	// ForceSendFields is a list of field names (e.g. "KillRunning") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "KillRunning") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsTaskCancelRequest: Request to cancel one task.

func (SwarmingRpcsTaskCancelRequest) MarshalJSON

func (s SwarmingRpcsTaskCancelRequest) MarshalJSON() ([]byte, error)

type SwarmingRpcsTaskList

type SwarmingRpcsTaskList struct {
	Cursor string `json:"cursor,omitempty"`
	// Items: Representation of the TaskResultSummary or TaskRunResult ndb model.
	Items []*SwarmingRpcsTaskResult `json:"items,omitempty"`
	Now   string                    `json:"now,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Cursor") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Cursor") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsTaskList: Wraps a list of TaskResult.

func (SwarmingRpcsTaskList) MarshalJSON

func (s SwarmingRpcsTaskList) MarshalJSON() ([]byte, error)

type SwarmingRpcsTaskOutput

type SwarmingRpcsTaskOutput struct {
	Output string `json:"output,omitempty"`
	// Possible values:
	//   "BOT_DIED"
	//   "CANCELED"
	//   "CLIENT_ERROR"
	//   "COMPLETED"
	//   "EXPIRED"
	//   "INVALID"
	//   "KILLED"
	//   "NO_RESOURCE"
	//   "PENDING"
	//   "RUNNING"
	//   "TIMED_OUT"
	State string `json:"state,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Output") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Output") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsTaskOutput: A task's output as a string.

func (SwarmingRpcsTaskOutput) MarshalJSON

func (s SwarmingRpcsTaskOutput) MarshalJSON() ([]byte, error)

type SwarmingRpcsTaskProperties

type SwarmingRpcsTaskProperties struct {
	// Caches: Describes a named cache that should be present on the bot. A
	// CacheEntry in a task specified that the task prefers the cache to be present
	// on the bot. A symlink to the cache directory is created at <run_dir>/|path|.
	// If cache is not present on the machine, the directory is empty. If the tasks
	// makes any changes to the contents of the cache directory, they are persisted
	// on the machine. If another task runs on the same machine and requests the
	// same named cache, even if mapped to a different path, it will see the
	// changes.
	Caches       []*SwarmingRpcsCacheEntry `json:"caches,omitempty"`
	CasInputRoot *SwarmingRpcsCASReference `json:"cas_input_root,omitempty"`
	// CipdInput: Defines CIPD packages to install in task run directory.
	CipdInput *SwarmingRpcsCipdInput `json:"cipd_input,omitempty"`
	Command   []string               `json:"command,omitempty"`
	// Containment: See proto/api/swarming.proto for description.
	Containment *SwarmingRpcsContainment `json:"containment,omitempty"`
	// Dimensions: Represents a mapping of string to string.
	Dimensions []*SwarmingRpcsStringPair `json:"dimensions,omitempty"`
	// Env: Represents a mapping of string to string.
	Env []*SwarmingRpcsStringPair `json:"env,omitempty"`
	// EnvPrefixes: Represents a mapping of string to list of strings.
	EnvPrefixes          []*SwarmingRpcsStringListPair `json:"env_prefixes,omitempty"`
	ExecutionTimeoutSecs int64                         `json:"execution_timeout_secs,omitempty,string"`
	GracePeriodSecs      int64                         `json:"grace_period_secs,omitempty,string"`
	Idempotent           bool                          `json:"idempotent,omitempty"`
	IoTimeoutSecs        int64                         `json:"io_timeout_secs,omitempty,string"`
	Outputs              []string                      `json:"outputs,omitempty"`
	RelativeCwd          string                        `json:"relative_cwd,omitempty"`
	SecretBytes          string                        `json:"secret_bytes,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Caches") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Caches") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsTaskProperties: Important metadata about a particular task.

func (SwarmingRpcsTaskProperties) MarshalJSON

func (s SwarmingRpcsTaskProperties) MarshalJSON() ([]byte, error)

type SwarmingRpcsTaskQueue

type SwarmingRpcsTaskQueue struct {
	Dimensions   []string `json:"dimensions,omitempty"`
	ValidUntilTs string   `json:"valid_until_ts,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Dimensions") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Dimensions") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (SwarmingRpcsTaskQueue) MarshalJSON

func (s SwarmingRpcsTaskQueue) MarshalJSON() ([]byte, error)

type SwarmingRpcsTaskQueueList

type SwarmingRpcsTaskQueueList struct {
	Cursor string                   `json:"cursor,omitempty"`
	Items  []*SwarmingRpcsTaskQueue `json:"items,omitempty"`
	Now    string                   `json:"now,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Cursor") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Cursor") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (SwarmingRpcsTaskQueueList) MarshalJSON

func (s SwarmingRpcsTaskQueueList) MarshalJSON() ([]byte, error)

type SwarmingRpcsTaskRequest

type SwarmingRpcsTaskRequest struct {
	Authenticated        string `json:"authenticated,omitempty"`
	BotPingToleranceSecs int64  `json:"bot_ping_tolerance_secs,omitempty,string"`
	CreatedTs            string `json:"created_ts,omitempty"`
	ExpirationSecs       int64  `json:"expiration_secs,omitempty,string"`
	Name                 string `json:"name,omitempty"`
	ParentTaskId         string `json:"parent_task_id,omitempty"`
	Priority             int64  `json:"priority,omitempty,string"`
	// Properties: Important metadata about a particular task.
	Properties     *SwarmingRpcsTaskProperties `json:"properties,omitempty"`
	PubsubTopic    string                      `json:"pubsub_topic,omitempty"`
	PubsubUserdata string                      `json:"pubsub_userdata,omitempty"`
	RbeInstance    string                      `json:"rbe_instance,omitempty"`
	Realm          string                      `json:"realm,omitempty"`
	// Resultdb: Swarming:ResultDB integration configuration for a task. See
	// NewTaskRequest.resultdb for more details.
	Resultdb       *SwarmingRpcsResultDBCfg `json:"resultdb,omitempty"`
	ServiceAccount string                   `json:"service_account,omitempty"`
	Tags           []string                 `json:"tags,omitempty"`
	TaskId         string                   `json:"task_id,omitempty"`
	// TaskSlices: Defines a possible task execution for a task request to be run
	// on the Swarming infrastructure. This is one of the possible fallback on a
	// task request.
	TaskSlices []*SwarmingRpcsTaskSlice `json:"task_slices,omitempty"`
	User       string                   `json:"user,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Authenticated") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Authenticated") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsTaskRequest: Description of a task request as registered by the server. This message is used when retrieving information about an existing task. See NewTaskRequest for more details.

func (SwarmingRpcsTaskRequest) MarshalJSON

func (s SwarmingRpcsTaskRequest) MarshalJSON() ([]byte, error)

type SwarmingRpcsTaskRequestMetadata

type SwarmingRpcsTaskRequestMetadata struct {
	// Request: Description of a task request as registered by the server. This
	// message is used when retrieving information about an existing task. See
	// NewTaskRequest for more details.
	Request *SwarmingRpcsTaskRequest `json:"request,omitempty"`
	TaskId  string                   `json:"task_id,omitempty"`
	// TaskResult: Representation of the TaskResultSummary or TaskRunResult ndb
	// model.
	TaskResult *SwarmingRpcsTaskResult `json:"task_result,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Request") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Request") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsTaskRequestMetadata: Provides the ID of the requested TaskRequest.

func (SwarmingRpcsTaskRequestMetadata) MarshalJSON

func (s SwarmingRpcsTaskRequestMetadata) MarshalJSON() ([]byte, error)

type SwarmingRpcsTaskRequests

type SwarmingRpcsTaskRequests struct {
	Cursor string `json:"cursor,omitempty"`
	// Items: Description of a task request as registered by the server. This
	// message is used when retrieving information about an existing task. See
	// NewTaskRequest for more details.
	Items []*SwarmingRpcsTaskRequest `json:"items,omitempty"`
	Now   string                     `json:"now,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Cursor") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Cursor") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsTaskRequests: Wraps a list of TaskRequest.

func (SwarmingRpcsTaskRequests) MarshalJSON

func (s SwarmingRpcsTaskRequests) MarshalJSON() ([]byte, error)

type SwarmingRpcsTaskResult

type SwarmingRpcsTaskResult struct {
	AbandonedTs string `json:"abandoned_ts,omitempty"`
	// BotDimensions: Represents a mapping of string to list of strings.
	BotDimensions       []*SwarmingRpcsStringListPair `json:"bot_dimensions,omitempty"`
	BotId               string                        `json:"bot_id,omitempty"`
	BotIdleSinceTs      string                        `json:"bot_idle_since_ts,omitempty"`
	BotLogsCloudProject string                        `json:"bot_logs_cloud_project,omitempty"`
	BotVersion          string                        `json:"bot_version,omitempty"`
	CasOutputRoot       *SwarmingRpcsCASReference     `json:"cas_output_root,omitempty"`
	// CipdPins: Defines pinned CIPD packages that were installed during the task.
	CipdPins         *SwarmingRpcsCipdPins       `json:"cipd_pins,omitempty"`
	CompletedTs      string                      `json:"completed_ts,omitempty"`
	CostSavedUsd     float64                     `json:"cost_saved_usd,omitempty"`
	CostsUsd         []float64                   `json:"costs_usd,omitempty"`
	CreatedTs        string                      `json:"created_ts,omitempty"`
	CurrentTaskSlice int64                       `json:"current_task_slice,omitempty,string"`
	DedupedFrom      string                      `json:"deduped_from,omitempty"`
	Duration         float64                     `json:"duration,omitempty"`
	ExitCode         int64                       `json:"exit_code,omitempty,string"`
	Failure          bool                        `json:"failure,omitempty"`
	InternalFailure  bool                        `json:"internal_failure,omitempty"`
	MissingCas       []*SwarmingRpcsCASReference `json:"missing_cas,omitempty"`
	// MissingCipd: A CIPD package to install in the run dir before task execution.
	MissingCipd []*SwarmingRpcsCipdPackage `json:"missing_cipd,omitempty"`
	ModifiedTs  string                     `json:"modified_ts,omitempty"`
	Name        string                     `json:"name,omitempty"`
	// PerformanceStats: Performance stats of task execution. See
	// task_result.PerformanceStats for details.
	PerformanceStats *SwarmingRpcsPerformanceStats `json:"performance_stats,omitempty"`
	// ResultdbInfo: ResultDB related properties.
	ResultdbInfo   *SwarmingRpcsResultDBInfo `json:"resultdb_info,omitempty"`
	RunId          string                    `json:"run_id,omitempty"`
	ServerVersions []string                  `json:"server_versions,omitempty"`
	StartedTs      string                    `json:"started_ts,omitempty"`
	// Possible values:
	//   "BOT_DIED"
	//   "CANCELED"
	//   "CLIENT_ERROR"
	//   "COMPLETED"
	//   "EXPIRED"
	//   "INVALID"
	//   "KILLED"
	//   "NO_RESOURCE"
	//   "PENDING"
	//   "RUNNING"
	//   "TIMED_OUT"
	State  string   `json:"state,omitempty"`
	Tags   []string `json:"tags,omitempty"`
	TaskId string   `json:"task_id,omitempty"`
	User   string   `json:"user,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "AbandonedTs") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "AbandonedTs") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsTaskResult: Representation of the TaskResultSummary or TaskRunResult ndb model.

func (SwarmingRpcsTaskResult) MarshalJSON

func (s SwarmingRpcsTaskResult) MarshalJSON() ([]byte, error)

func (*SwarmingRpcsTaskResult) UnmarshalJSON

func (s *SwarmingRpcsTaskResult) UnmarshalJSON(data []byte) error

type SwarmingRpcsTaskSlice

type SwarmingRpcsTaskSlice struct {
	ExpirationSecs int64 `json:"expiration_secs,omitempty,string"`
	// Properties: Important metadata about a particular task.
	Properties      *SwarmingRpcsTaskProperties `json:"properties,omitempty"`
	WaitForCapacity bool                        `json:"wait_for_capacity,omitempty"`
	// ForceSendFields is a list of field names (e.g. "ExpirationSecs") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "ExpirationSecs") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsTaskSlice: Defines a possible task execution for a task request to be run on the Swarming infrastructure. This is one of the possible fallback on a task request.

func (SwarmingRpcsTaskSlice) MarshalJSON

func (s SwarmingRpcsTaskSlice) MarshalJSON() ([]byte, error)

type SwarmingRpcsTaskStates

type SwarmingRpcsTaskStates struct {
	// Possible values:
	//   "BOT_DIED"
	//   "CANCELED"
	//   "CLIENT_ERROR"
	//   "COMPLETED"
	//   "EXPIRED"
	//   "INVALID"
	//   "KILLED"
	//   "NO_RESOURCE"
	//   "PENDING"
	//   "RUNNING"
	//   "TIMED_OUT"
	States []string `json:"states,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "States") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "States") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsTaskStates: Only holds states. Used in the 'get_states' RPC.

func (SwarmingRpcsTaskStates) MarshalJSON

func (s SwarmingRpcsTaskStates) MarshalJSON() ([]byte, error)

type SwarmingRpcsTasksCancelRequest

type SwarmingRpcsTasksCancelRequest struct {
	Cursor      string  `json:"cursor,omitempty"`
	End         float64 `json:"end,omitempty"`
	KillRunning bool    `json:"kill_running,omitempty"`
	// Default: 100
	Limit *int64   `json:"limit,omitempty,string"`
	Start float64  `json:"start,omitempty"`
	Tags  []string `json:"tags,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Cursor") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Cursor") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsTasksCancelRequest: Request to cancel some subset of pending/running tasks.

func (SwarmingRpcsTasksCancelRequest) MarshalJSON

func (s SwarmingRpcsTasksCancelRequest) MarshalJSON() ([]byte, error)

func (*SwarmingRpcsTasksCancelRequest) UnmarshalJSON

func (s *SwarmingRpcsTasksCancelRequest) UnmarshalJSON(data []byte) error

type SwarmingRpcsTasksCancelResponse

type SwarmingRpcsTasksCancelResponse struct {
	Cursor  string `json:"cursor,omitempty"`
	Matched int64  `json:"matched,omitempty,string"`
	Now     string `json:"now,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Cursor") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Cursor") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsTasksCancelResponse: Result of canceling some subset of pending tasks.

func (SwarmingRpcsTasksCancelResponse) MarshalJSON

func (s SwarmingRpcsTasksCancelResponse) MarshalJSON() ([]byte, error)

type SwarmingRpcsTasksCount

type SwarmingRpcsTasksCount struct {
	Count int64  `json:"count,omitempty,string"`
	Now   string `json:"now,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Count") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Count") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsTasksCount: Returns the count, as requested.

func (SwarmingRpcsTasksCount) MarshalJSON

func (s SwarmingRpcsTasksCount) MarshalJSON() ([]byte, error)

type SwarmingRpcsTerminateResponse

type SwarmingRpcsTerminateResponse struct {
	TaskId string `json:"task_id,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "TaskId") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "TaskId") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SwarmingRpcsTerminateResponse: Returns the pseudo taskid to wait for the bot to shut down.

func (SwarmingRpcsTerminateResponse) MarshalJSON

func (s SwarmingRpcsTerminateResponse) MarshalJSON() ([]byte, error)

type TaskCancelCall

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

func (*TaskCancelCall) Context

func (c *TaskCancelCall) Context(ctx context.Context) *TaskCancelCall

Context sets the context to be used in this call's Do method.

func (*TaskCancelCall) Do

Do executes the "swarming.task.cancel" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsCancelResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*TaskCancelCall) Fields

func (c *TaskCancelCall) Fields(s ...googleapi.Field) *TaskCancelCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*TaskCancelCall) Header

func (c *TaskCancelCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type TaskRequestCall

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

func (*TaskRequestCall) Context

Context sets the context to be used in this call's Do method.

func (*TaskRequestCall) Do

Do executes the "swarming.task.request" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsTaskRequest.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*TaskRequestCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*TaskRequestCall) Header

func (c *TaskRequestCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*TaskRequestCall) IfNoneMatch

func (c *TaskRequestCall) IfNoneMatch(entityTag string) *TaskRequestCall

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

type TaskResultCall

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

func (*TaskResultCall) Context

func (c *TaskResultCall) Context(ctx context.Context) *TaskResultCall

Context sets the context to be used in this call's Do method.

func (*TaskResultCall) Do

Do executes the "swarming.task.result" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsTaskResult.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*TaskResultCall) Fields

func (c *TaskResultCall) Fields(s ...googleapi.Field) *TaskResultCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*TaskResultCall) Header

func (c *TaskResultCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*TaskResultCall) IfNoneMatch

func (c *TaskResultCall) IfNoneMatch(entityTag string) *TaskResultCall

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

func (*TaskResultCall) IncludePerformanceStats

func (c *TaskResultCall) IncludePerformanceStats(includePerformanceStats bool) *TaskResultCall

IncludePerformanceStats sets the optional parameter "include_performance_stats":

type TaskService

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

func NewTaskService

func NewTaskService(s *Service) *TaskService

func (*TaskService) Cancel

func (r *TaskService) Cancel(taskId string, swarmingrpcstaskcancelrequest *SwarmingRpcsTaskCancelRequest) *TaskCancelCall

Cancel: Cancels a task. If a bot was running the task, the bot will forcibly cancel the task.

- taskId: .

func (*TaskService) Request

func (r *TaskService) Request(taskId string) *TaskRequestCall

Request: Returns the task request corresponding to a task ID.

- taskId: .

func (*TaskService) Result

func (r *TaskService) Result(taskId string) *TaskResultCall

Result: Reports the result of the task corresponding to a task ID. It can be a 'run' ID specifying a specific retry or a 'summary' ID hidding the fact that a task may have been retried transparently, when a bot reports BOT_DIED. A summary ID ends with '0', a run ID ends with '1' or '2'.

- taskId: .

func (*TaskService) Stdout

func (r *TaskService) Stdout(taskId string) *TaskStdoutCall

Stdout: Returns the output of the task corresponding to a task ID.

- taskId: .

type TaskStdoutCall

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

func (*TaskStdoutCall) Context

func (c *TaskStdoutCall) Context(ctx context.Context) *TaskStdoutCall

Context sets the context to be used in this call's Do method.

func (*TaskStdoutCall) Do

Do executes the "swarming.task.stdout" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsTaskOutput.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*TaskStdoutCall) Fields

func (c *TaskStdoutCall) Fields(s ...googleapi.Field) *TaskStdoutCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*TaskStdoutCall) Header

func (c *TaskStdoutCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*TaskStdoutCall) IfNoneMatch

func (c *TaskStdoutCall) IfNoneMatch(entityTag string) *TaskStdoutCall

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

func (*TaskStdoutCall) Length

func (c *TaskStdoutCall) Length(length int64) *TaskStdoutCall

Length sets the optional parameter "length":

func (*TaskStdoutCall) Offset

func (c *TaskStdoutCall) Offset(offset int64) *TaskStdoutCall

Offset sets the optional parameter "offset":

type TasksCancelCall

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

func (*TasksCancelCall) Context

Context sets the context to be used in this call's Do method.

func (*TasksCancelCall) Do

Do executes the "swarming.tasks.cancel" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsTasksCancelResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*TasksCancelCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*TasksCancelCall) Header

func (c *TasksCancelCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type TasksCountCall

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

func (*TasksCountCall) Context

func (c *TasksCountCall) Context(ctx context.Context) *TasksCountCall

Context sets the context to be used in this call's Do method.

func (*TasksCountCall) Do

Do executes the "swarming.tasks.count" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsTasksCount.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*TasksCountCall) End

func (c *TasksCountCall) End(end float64) *TasksCountCall

End sets the optional parameter "end":

func (*TasksCountCall) Fields

func (c *TasksCountCall) Fields(s ...googleapi.Field) *TasksCountCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*TasksCountCall) Header

func (c *TasksCountCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*TasksCountCall) IfNoneMatch

func (c *TasksCountCall) IfNoneMatch(entityTag string) *TasksCountCall

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

func (*TasksCountCall) Start

func (c *TasksCountCall) Start(start float64) *TasksCountCall

Start sets the optional parameter "start":

func (*TasksCountCall) State

func (c *TasksCountCall) State(state string) *TasksCountCall

State sets the optional parameter "state":

Possible values:

"ALL" (default)
"BOT_DIED"
"CANCELED"
"CLIENT_ERROR"
"COMPLETED"
"COMPLETED_FAILURE"
"COMPLETED_SUCCESS"
"DEDUPED"
"EXPIRED"
"KILLED"
"NO_RESOURCE"
"PENDING"
"PENDING_RUNNING"
"RUNNING"
"TIMED_OUT"

func (*TasksCountCall) Tags

func (c *TasksCountCall) Tags(tags ...string) *TasksCountCall

Tags sets the optional parameter "tags":

type TasksGetStatesCall

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

func (*TasksGetStatesCall) Context

Context sets the context to be used in this call's Do method.

func (*TasksGetStatesCall) Do

Do executes the "swarming.tasks.get_states" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsTaskStates.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*TasksGetStatesCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*TasksGetStatesCall) Header

func (c *TasksGetStatesCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*TasksGetStatesCall) IfNoneMatch

func (c *TasksGetStatesCall) IfNoneMatch(entityTag string) *TasksGetStatesCall

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

func (*TasksGetStatesCall) TaskId

func (c *TasksGetStatesCall) TaskId(taskId ...string) *TasksGetStatesCall

TaskId sets the optional parameter "task_id":

type TasksListCall

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

func (*TasksListCall) Context

func (c *TasksListCall) Context(ctx context.Context) *TasksListCall

Context sets the context to be used in this call's Do method.

func (*TasksListCall) Cursor

func (c *TasksListCall) Cursor(cursor string) *TasksListCall

Cursor sets the optional parameter "cursor":

func (*TasksListCall) Do

Do executes the "swarming.tasks.list" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsTaskList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*TasksListCall) End

func (c *TasksListCall) End(end float64) *TasksListCall

End sets the optional parameter "end":

func (*TasksListCall) Fields

func (c *TasksListCall) Fields(s ...googleapi.Field) *TasksListCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*TasksListCall) Header

func (c *TasksListCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*TasksListCall) IfNoneMatch

func (c *TasksListCall) IfNoneMatch(entityTag string) *TasksListCall

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

func (*TasksListCall) IncludePerformanceStats

func (c *TasksListCall) IncludePerformanceStats(includePerformanceStats bool) *TasksListCall

IncludePerformanceStats sets the optional parameter "include_performance_stats":

func (*TasksListCall) Limit

func (c *TasksListCall) Limit(limit int64) *TasksListCall

Limit sets the optional parameter "limit":

func (*TasksListCall) Sort

func (c *TasksListCall) Sort(sort string) *TasksListCall

Sort sets the optional parameter "sort":

Possible values:

"ABANDONED_TS"
"COMPLETED_TS"
"CREATED_TS" (default)
"STARTED_TS"

func (*TasksListCall) Start

func (c *TasksListCall) Start(start float64) *TasksListCall

Start sets the optional parameter "start":

func (*TasksListCall) State

func (c *TasksListCall) State(state string) *TasksListCall

State sets the optional parameter "state":

Possible values:

"ALL" (default)
"BOT_DIED"
"CANCELED"
"CLIENT_ERROR"
"COMPLETED"
"COMPLETED_FAILURE"
"COMPLETED_SUCCESS"
"DEDUPED"
"EXPIRED"
"KILLED"
"NO_RESOURCE"
"PENDING"
"PENDING_RUNNING"
"RUNNING"
"TIMED_OUT"

func (*TasksListCall) Tags

func (c *TasksListCall) Tags(tags ...string) *TasksListCall

Tags sets the optional parameter "tags":

type TasksNewCall

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

func (*TasksNewCall) Context

func (c *TasksNewCall) Context(ctx context.Context) *TasksNewCall

Context sets the context to be used in this call's Do method.

func (*TasksNewCall) Do

Do executes the "swarming.tasks.new" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsTaskRequestMetadata.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*TasksNewCall) Fields

func (c *TasksNewCall) Fields(s ...googleapi.Field) *TasksNewCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*TasksNewCall) Header

func (c *TasksNewCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type TasksRequestsCall

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

func (*TasksRequestsCall) Context

Context sets the context to be used in this call's Do method.

func (*TasksRequestsCall) Cursor

func (c *TasksRequestsCall) Cursor(cursor string) *TasksRequestsCall

Cursor sets the optional parameter "cursor":

func (*TasksRequestsCall) Do

Do executes the "swarming.tasks.requests" call. Any non-2xx status code is an error. Response headers are in either *SwarmingRpcsTaskRequests.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*TasksRequestsCall) End

End sets the optional parameter "end":

func (*TasksRequestsCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*TasksRequestsCall) Header

func (c *TasksRequestsCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*TasksRequestsCall) IfNoneMatch

func (c *TasksRequestsCall) IfNoneMatch(entityTag string) *TasksRequestsCall

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

func (*TasksRequestsCall) IncludePerformanceStats

func (c *TasksRequestsCall) IncludePerformanceStats(includePerformanceStats bool) *TasksRequestsCall

IncludePerformanceStats sets the optional parameter "include_performance_stats":

func (*TasksRequestsCall) Limit

func (c *TasksRequestsCall) Limit(limit int64) *TasksRequestsCall

Limit sets the optional parameter "limit":

func (*TasksRequestsCall) Sort

Sort sets the optional parameter "sort":

Possible values:

"ABANDONED_TS"
"COMPLETED_TS"
"CREATED_TS" (default)
"STARTED_TS"

func (*TasksRequestsCall) Start

func (c *TasksRequestsCall) Start(start float64) *TasksRequestsCall

Start sets the optional parameter "start":

func (*TasksRequestsCall) State

func (c *TasksRequestsCall) State(state string) *TasksRequestsCall

State sets the optional parameter "state":

Possible values:

"ALL" (default)
"BOT_DIED"
"CANCELED"
"CLIENT_ERROR"
"COMPLETED"
"COMPLETED_FAILURE"
"COMPLETED_SUCCESS"
"DEDUPED"
"EXPIRED"
"KILLED"
"NO_RESOURCE"
"PENDING"
"PENDING_RUNNING"
"RUNNING"
"TIMED_OUT"

func (*TasksRequestsCall) Tags

func (c *TasksRequestsCall) Tags(tags ...string) *TasksRequestsCall

Tags sets the optional parameter "tags":

type TasksService

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

func NewTasksService

func NewTasksService(s *Service) *TasksService

func (*TasksService) Cancel

func (r *TasksService) Cancel(swarmingrpcstaskscancelrequest *SwarmingRpcsTasksCancelRequest) *TasksCancelCall

Cancel: Cancel a subset of pending tasks based on the tags. Cancellation happens asynchronously, so when this call returns, cancellations will not have completed yet.

func (*TasksService) Count

func (r *TasksService) Count() *TasksCountCall

Count: Counts number of tasks in a given state.

func (*TasksService) GetStates

func (r *TasksService) GetStates() *TasksGetStatesCall

GetStates: Returns task state for a specific set of tasks.

func (*TasksService) List

func (r *TasksService) List() *TasksListCall

List: Returns full task results based on the filters. This endpoint is significantly slower than 'count'. Use 'count' when possible. If you just want the state of tasks, use 'get_states'.

func (*TasksService) New

func (r *TasksService) New(swarmingrpcsnewtaskrequest *SwarmingRpcsNewTaskRequest) *TasksNewCall

New: Creates a new task. The task will be enqueued in the tasks list and will be executed at the earliest opportunity by a bot that has at least the dimensions as described in the task request.

func (*TasksService) Requests

func (r *TasksService) Requests() *TasksRequestsCall

Requests: Returns tasks requests based on the filters. This endpoint is slightly slower than 'list'. Use 'list' or 'count' when possible.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL