client

package
v0.11.0 Latest Latest
Warning

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

 Go to latest Published: Oct 25, 2026 License: Apache-2.0 Imports: 12 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func AvailabilityAgentupgradesPath 

func AvailabilityAgentupgradesPath(name string) string

AvailabilityAgentupgradesPath returns the URL path to the agentupgrades service availability HTTP endpoint.

func BuildAvailabilityPayload 

func BuildAvailabilityPayload(agentupgradesAvailabilityName string, agentupgradesAvailabilityNamespace string) (*agentupgrades.AvailabilityPayload, error)

BuildAvailabilityPayload builds the payload for the agentupgrades availability endpoint from CLI flags.

func BuildCancelPayload 

func BuildCancelPayload(agentupgradesCancelName string, agentupgradesCancelAttemptID string, agentupgradesCancelNamespace string) (*agentupgrades.CancelPayload, error)

BuildCancelPayload builds the payload for the agentupgrades cancel endpoint from CLI flags.

func BuildRollbackPayload 

func BuildRollbackPayload(agentupgradesRollbackName string, agentupgradesRollbackAttemptID string, agentupgradesRollbackNamespace string) (*agentupgrades.RollbackPayload, error)

BuildRollbackPayload builds the payload for the agentupgrades rollback endpoint from CLI flags.

func BuildStartPayload 

func BuildStartPayload(agentupgradesStartBody string, agentupgradesStartName string, agentupgradesStartNamespace string) (*agentupgrades.AgentUpgradeStartPayload, error)

BuildStartPayload builds the payload for the agentupgrades start endpoint from CLI flags.

func BuildStatusPayload 

func BuildStatusPayload(agentupgradesStatusName string, agentupgradesStatusAttemptID string, agentupgradesStatusNamespace string) (*agentupgrades.StatusPayload, error)

BuildStatusPayload builds the payload for the agentupgrades status endpoint from CLI flags.

func CancelAgentupgradesPath 

func CancelAgentupgradesPath(name string, attemptID string) string

CancelAgentupgradesPath returns the URL path to the agentupgrades service cancel HTTP endpoint.

func DecodeAvailabilityResponse 

func DecodeAvailabilityResponse(decoder func(*http.Response) goahttp.Decoder, restoreBody bool) func(*http.Response) (any, error)

DecodeAvailabilityResponse returns a decoder for responses returned by the agentupgrades availability endpoint. restoreBody controls whether the response body should be restored after having been read. DecodeAvailabilityResponse may return the following errors:

  • "conflict" (type agentupgrades.Conflict): http.StatusConflict
  • "forbidden" (type agentupgrades.Forbidden): http.StatusForbidden
  • "invalid" (type agentupgrades.Invalid): http.StatusBadRequest
  • "not_found" (type agentupgrades.NotFound): http.StatusNotFound
  • "unauthorized" (type agentupgrades.Unauthorized): http.StatusUnauthorized
  • "unavailable" (type agentupgrades.Unavailable): http.StatusServiceUnavailable
  • error: internal error

func DecodeCancelResponse 

func DecodeCancelResponse(decoder func(*http.Response) goahttp.Decoder, restoreBody bool) func(*http.Response) (any, error)

DecodeCancelResponse returns a decoder for responses returned by the agentupgrades cancel endpoint. restoreBody controls whether the response body should be restored after having been read. DecodeCancelResponse may return the following errors:

  • "conflict" (type agentupgrades.Conflict): http.StatusConflict
  • "forbidden" (type agentupgrades.Forbidden): http.StatusForbidden
  • "invalid" (type agentupgrades.Invalid): http.StatusBadRequest
  • "not_found" (type agentupgrades.NotFound): http.StatusNotFound
  • "unauthorized" (type agentupgrades.Unauthorized): http.StatusUnauthorized
  • "unavailable" (type agentupgrades.Unavailable): http.StatusServiceUnavailable
  • error: internal error

func DecodeRollbackResponse 

func DecodeRollbackResponse(decoder func(*http.Response) goahttp.Decoder, restoreBody bool) func(*http.Response) (any, error)

DecodeRollbackResponse returns a decoder for responses returned by the agentupgrades rollback endpoint. restoreBody controls whether the response body should be restored after having been read. DecodeRollbackResponse may return the following errors:

  • "conflict" (type agentupgrades.Conflict): http.StatusConflict
  • "forbidden" (type agentupgrades.Forbidden): http.StatusForbidden
  • "invalid" (type agentupgrades.Invalid): http.StatusBadRequest
  • "not_found" (type agentupgrades.NotFound): http.StatusNotFound
  • "unauthorized" (type agentupgrades.Unauthorized): http.StatusUnauthorized
  • "unavailable" (type agentupgrades.Unavailable): http.StatusServiceUnavailable
  • error: internal error

func DecodeStartResponse 

func DecodeStartResponse(decoder func(*http.Response) goahttp.Decoder, restoreBody bool) func(*http.Response) (any, error)

DecodeStartResponse returns a decoder for responses returned by the agentupgrades start endpoint. restoreBody controls whether the response body should be restored after having been read. DecodeStartResponse may return the following errors:

  • "conflict" (type agentupgrades.Conflict): http.StatusConflict
  • "forbidden" (type agentupgrades.Forbidden): http.StatusForbidden
  • "invalid" (type agentupgrades.Invalid): http.StatusBadRequest
  • "not_found" (type agentupgrades.NotFound): http.StatusNotFound
  • "unauthorized" (type agentupgrades.Unauthorized): http.StatusUnauthorized
  • "unavailable" (type agentupgrades.Unavailable): http.StatusServiceUnavailable
  • error: internal error

func DecodeStatusResponse 

func DecodeStatusResponse(decoder func(*http.Response) goahttp.Decoder, restoreBody bool) func(*http.Response) (any, error)

DecodeStatusResponse returns a decoder for responses returned by the agentupgrades status endpoint. restoreBody controls whether the response body should be restored after having been read. DecodeStatusResponse may return the following errors:

  • "conflict" (type agentupgrades.Conflict): http.StatusConflict
  • "forbidden" (type agentupgrades.Forbidden): http.StatusForbidden
  • "invalid" (type agentupgrades.Invalid): http.StatusBadRequest
  • "not_found" (type agentupgrades.NotFound): http.StatusNotFound
  • "unauthorized" (type agentupgrades.Unauthorized): http.StatusUnauthorized
  • "unavailable" (type agentupgrades.Unavailable): http.StatusServiceUnavailable
  • error: internal error

func EncodeAvailabilityRequest 

func EncodeAvailabilityRequest(encoder func(*http.Request) goahttp.Encoder) func(*http.Request, any) error

EncodeAvailabilityRequest returns an encoder for requests sent to the agentupgrades availability server.

func EncodeCancelRequest 

func EncodeCancelRequest(encoder func(*http.Request) goahttp.Encoder) func(*http.Request, any) error

EncodeCancelRequest returns an encoder for requests sent to the agentupgrades cancel server.

func EncodeRollbackRequest 

func EncodeRollbackRequest(encoder func(*http.Request) goahttp.Encoder) func(*http.Request, any) error

EncodeRollbackRequest returns an encoder for requests sent to the agentupgrades rollback server.

func EncodeStartRequest 

func EncodeStartRequest(encoder func(*http.Request) goahttp.Encoder) func(*http.Request, any) error

EncodeStartRequest returns an encoder for requests sent to the agentupgrades start server.

func EncodeStatusRequest 

func EncodeStatusRequest(encoder func(*http.Request) goahttp.Encoder) func(*http.Request, any) error

EncodeStatusRequest returns an encoder for requests sent to the agentupgrades status server.

func NewAvailabilityAgentUpgradeAvailabilityOK 

func NewAvailabilityAgentUpgradeAvailabilityOK(body *AvailabilityResponseBody) *agentupgradesviews.AgentUpgradeAvailabilityView

NewAvailabilityAgentUpgradeAvailabilityOK builds a "agentupgrades" service "availability" endpoint result from a HTTP "OK" response.

func NewAvailabilityConflict 

func NewAvailabilityConflict(body string) agentupgrades.Conflict

NewAvailabilityConflict builds a agentupgrades service availability endpoint conflict error.

func NewAvailabilityForbidden 

func NewAvailabilityForbidden(body string) agentupgrades.Forbidden

NewAvailabilityForbidden builds a agentupgrades service availability endpoint forbidden error.

func NewAvailabilityInvalid 

func NewAvailabilityInvalid(body string) agentupgrades.Invalid

NewAvailabilityInvalid builds a agentupgrades service availability endpoint invalid error.

func NewAvailabilityNotFound 

func NewAvailabilityNotFound(body string) agentupgrades.NotFound

NewAvailabilityNotFound builds a agentupgrades service availability endpoint not_found error.

func NewAvailabilityUnauthorized 

func NewAvailabilityUnauthorized(body string) agentupgrades.Unauthorized

NewAvailabilityUnauthorized builds a agentupgrades service availability endpoint unauthorized error.

func NewAvailabilityUnavailable 

func NewAvailabilityUnavailable(body string) agentupgrades.Unavailable

NewAvailabilityUnavailable builds a agentupgrades service availability endpoint unavailable error.

func NewCancelAgentUpgradeAttemptOK 

func NewCancelAgentUpgradeAttemptOK(body *CancelResponseBody) *agentupgradesviews.AgentUpgradeAttemptView

NewCancelAgentUpgradeAttemptOK builds a "agentupgrades" service "cancel" endpoint result from a HTTP "OK" response.

func NewCancelConflict 

func NewCancelConflict(body string) agentupgrades.Conflict

NewCancelConflict builds a agentupgrades service cancel endpoint conflict error.

func NewCancelForbidden 

func NewCancelForbidden(body string) agentupgrades.Forbidden

NewCancelForbidden builds a agentupgrades service cancel endpoint forbidden error.

func NewCancelInvalid 

func NewCancelInvalid(body string) agentupgrades.Invalid

NewCancelInvalid builds a agentupgrades service cancel endpoint invalid error.

func NewCancelNotFound 

func NewCancelNotFound(body string) agentupgrades.NotFound

NewCancelNotFound builds a agentupgrades service cancel endpoint not_found error.

func NewCancelUnauthorized 

func NewCancelUnauthorized(body string) agentupgrades.Unauthorized

NewCancelUnauthorized builds a agentupgrades service cancel endpoint unauthorized error.

func NewCancelUnavailable 

func NewCancelUnavailable(body string) agentupgrades.Unavailable

NewCancelUnavailable builds a agentupgrades service cancel endpoint unavailable error.

func NewRollbackAgentUpgradeAttemptAccepted 

func NewRollbackAgentUpgradeAttemptAccepted(body *RollbackResponseBody) *agentupgradesviews.AgentUpgradeAttemptView

NewRollbackAgentUpgradeAttemptAccepted builds a "agentupgrades" service "rollback" endpoint result from a HTTP "Accepted" response.

func NewRollbackConflict 

func NewRollbackConflict(body string) agentupgrades.Conflict

NewRollbackConflict builds a agentupgrades service rollback endpoint conflict error.

func NewRollbackForbidden 

func NewRollbackForbidden(body string) agentupgrades.Forbidden

NewRollbackForbidden builds a agentupgrades service rollback endpoint forbidden error.

func NewRollbackInvalid 

func NewRollbackInvalid(body string) agentupgrades.Invalid

NewRollbackInvalid builds a agentupgrades service rollback endpoint invalid error.

func NewRollbackNotFound 

func NewRollbackNotFound(body string) agentupgrades.NotFound

NewRollbackNotFound builds a agentupgrades service rollback endpoint not_found error.

func NewRollbackUnauthorized 

func NewRollbackUnauthorized(body string) agentupgrades.Unauthorized

NewRollbackUnauthorized builds a agentupgrades service rollback endpoint unauthorized error.

func NewRollbackUnavailable 

func NewRollbackUnavailable(body string) agentupgrades.Unavailable

NewRollbackUnavailable builds a agentupgrades service rollback endpoint unavailable error.

func NewStartAgentUpgradeAttemptAccepted 

func NewStartAgentUpgradeAttemptAccepted(body *StartResponseBody) *agentupgradesviews.AgentUpgradeAttemptView

NewStartAgentUpgradeAttemptAccepted builds a "agentupgrades" service "start" endpoint result from a HTTP "Accepted" response.

func NewStartConflict 

func NewStartConflict(body string) agentupgrades.Conflict

NewStartConflict builds a agentupgrades service start endpoint conflict error.

func NewStartForbidden 

func NewStartForbidden(body string) agentupgrades.Forbidden

NewStartForbidden builds a agentupgrades service start endpoint forbidden error.

func NewStartInvalid 

func NewStartInvalid(body string) agentupgrades.Invalid

NewStartInvalid builds a agentupgrades service start endpoint invalid error.

func NewStartNotFound 

func NewStartNotFound(body string) agentupgrades.NotFound

NewStartNotFound builds a agentupgrades service start endpoint not_found error.

func NewStartUnauthorized 

func NewStartUnauthorized(body string) agentupgrades.Unauthorized

NewStartUnauthorized builds a agentupgrades service start endpoint unauthorized error.

func NewStartUnavailable 

func NewStartUnavailable(body string) agentupgrades.Unavailable

NewStartUnavailable builds a agentupgrades service start endpoint unavailable error.

func NewStatusAgentUpgradeAttemptOK 

func NewStatusAgentUpgradeAttemptOK(body *StatusResponseBody) *agentupgradesviews.AgentUpgradeAttemptView

NewStatusAgentUpgradeAttemptOK builds a "agentupgrades" service "status" endpoint result from a HTTP "OK" response.

func NewStatusConflict 

func NewStatusConflict(body string) agentupgrades.Conflict

NewStatusConflict builds a agentupgrades service status endpoint conflict error.

func NewStatusForbidden 

func NewStatusForbidden(body string) agentupgrades.Forbidden

NewStatusForbidden builds a agentupgrades service status endpoint forbidden error.

func NewStatusInvalid 

func NewStatusInvalid(body string) agentupgrades.Invalid

NewStatusInvalid builds a agentupgrades service status endpoint invalid error.

func NewStatusNotFound 

func NewStatusNotFound(body string) agentupgrades.NotFound

NewStatusNotFound builds a agentupgrades service status endpoint not_found error.

func NewStatusUnauthorized 

func NewStatusUnauthorized(body string) agentupgrades.Unauthorized

NewStatusUnauthorized builds a agentupgrades service status endpoint unauthorized error.

func NewStatusUnavailable 

func NewStatusUnavailable(body string) agentupgrades.Unavailable

NewStatusUnavailable builds a agentupgrades service status endpoint unavailable error.

func RollbackAgentupgradesPath 

func RollbackAgentupgradesPath(name string, attemptID string) string

RollbackAgentupgradesPath returns the URL path to the agentupgrades service rollback HTTP endpoint.

func StartAgentupgradesPath 

func StartAgentupgradesPath(name string) string

StartAgentupgradesPath returns the URL path to the agentupgrades service start HTTP endpoint.

func StatusAgentupgradesPath 

func StatusAgentupgradesPath(name string, attemptID string) string

StatusAgentupgradesPath returns the URL path to the agentupgrades service status HTTP endpoint.

Types

type AvailabilityResponseBody 

type AvailabilityResponseBody struct {
	// Platform policy admits agent upgrades
	PolicyEnabled *bool `form:"policy_enabled,omitempty" json:"policy_enabled,omitempty" xml:"policy_enabled,omitempty"`
	// Durable attempt/recording storage is ready
	StorageAvailable *bool `form:"storage_available,omitempty" json:"storage_available,omitempty" xml:"storage_available,omitempty"`
	// Workspace resolves as an eligible running Windows VM
	WorkspaceEligible *bool `form:"workspace_eligible,omitempty" json:"workspace_eligible,omitempty" xml:"workspace_eligible,omitempty"`
	// Fresh authenticated guest inventory is available (guest integration)
	InventoryAvailable *bool `form:"inventory_available,omitempty" json:"inventory_available,omitempty" xml:"inventory_available,omitempty"`
	// A start request would be admitted right now
	Admissible *bool `form:"admissible,omitempty" json:"admissible,omitempty" xml:"admissible,omitempty"`
	// Why start would be denied; empty when admissible
	DenyReason *string `form:"deny_reason,omitempty" json:"deny_reason,omitempty" xml:"deny_reason,omitempty"`
	// Reservation-holding attempt for this VM, when present
	ActiveAttemptID *string `form:"active_attempt_id,omitempty" json:"active_attempt_id,omitempty" xml:"active_attempt_id,omitempty"`
	// Resolved controller-owned VM UID, when eligible
	VMUID *string `form:"vm_uid,omitempty" json:"vm_uid,omitempty" xml:"vm_uid,omitempty"`
}

AvailabilityResponseBody is the type of the "agentupgrades" service "availability" endpoint HTTP response body.

type CancelResponseBody 

type CancelResponseBody struct {
	// Server-minted attempt identifier
	AttemptID     *string `form:"attempt_id,omitempty" json:"attempt_id,omitempty" xml:"attempt_id,omitempty"`
	Namespace     *string `form:"namespace,omitempty" json:"namespace,omitempty" xml:"namespace,omitempty"`
	WorkspaceName *string `form:"workspace_name,omitempty" json:"workspace_name,omitempty" xml:"workspace_name,omitempty"`
	WorkspaceUID  *string `form:"workspace_uid,omitempty" json:"workspace_uid,omitempty" xml:"workspace_uid,omitempty"`
	// Controller-owned VM UID the reservation is bound to
	VMUID *string `form:"vm_uid,omitempty" json:"vm_uid,omitempty" xml:"vm_uid,omitempty"`
	// UID of the administrator that admitted the attempt
	ActorID *string `form:"actor_id,omitempty" json:"actor_id,omitempty" xml:"actor_id,omitempty"`
	// Attempt lifecycle state
	State                            *string `form:"state,omitempty" json:"state,omitempty" xml:"state,omitempty"`
	TargetID                         *string `form:"target_id,omitempty" json:"target_id,omitempty" xml:"target_id,omitempty"`
	TargetManifestSha256             *string `form:"target_manifest_sha256,omitempty" json:"target_manifest_sha256,omitempty" xml:"target_manifest_sha256,omitempty"`
	ExpectedInstalledInventorySha256 *string `` /* 157-byte string literal not displayed */
	// Whether the admitted attempt may run the bounded reboot sequence
	AllowReboot *bool `form:"allow_reboot,omitempty" json:"allow_reboot,omitempty" xml:"allow_reboot,omitempty"`
	// An administrator requested safe-boundary cancellation
	CancelRequested *bool `form:"cancel_requested,omitempty" json:"cancel_requested,omitempty" xml:"cancel_requested,omitempty"`
	// Linked execution admission record (recording authorization)
	ExecutionID *string `form:"execution_id,omitempty" json:"execution_id,omitempty" xml:"execution_id,omitempty"`
	// Protected attempt recording
	RecordingID *string `form:"recording_id,omitempty" json:"recording_id,omitempty" xml:"recording_id,omitempty"`
	// Independently authorized recording link
	RecordingURL *string `form:"recording_url,omitempty" json:"recording_url,omitempty" xml:"recording_url,omitempty"`
	// Canonical status URL for this attempt
	StatusURL *string `form:"status_url,omitempty" json:"status_url,omitempty" xml:"status_url,omitempty"`
	// Last reconciled guest journal sequence
	JournalSequence *uint64 `form:"journal_sequence,omitempty" json:"journal_sequence,omitempty" xml:"journal_sequence,omitempty"`
	// Pinned rollback predecessor target
	PredecessorTargetID *string `form:"predecessor_target_id,omitempty" json:"predecessor_target_id,omitempty" xml:"predecessor_target_id,omitempty"`
	// Pinned rollback predecessor manifest digest
	PredecessorManifestSha256 *string `` /* 133-byte string literal not displayed */
	// Bounded machine-readable failure code
	ErrorCode *string `form:"error_code,omitempty" json:"error_code,omitempty" xml:"error_code,omitempty"`
	// RFC3339 admission timestamp
	AdmittedAt          *string `form:"admitted_at,omitempty" json:"admitted_at,omitempty" xml:"admitted_at,omitempty"`
	StagingAt           *string `form:"staging_at,omitempty" json:"staging_at,omitempty" xml:"staging_at,omitempty"`
	PreparedAt          *string `form:"prepared_at,omitempty" json:"prepared_at,omitempty" xml:"prepared_at,omitempty"`
	InstallingAt        *string `form:"installing_at,omitempty" json:"installing_at,omitempty" xml:"installing_at,omitempty"`
	AwaitingRebootAt    *string `form:"awaiting_reboot_at,omitempty" json:"awaiting_reboot_at,omitempty" xml:"awaiting_reboot_at,omitempty"`
	VerifyingAt         *string `form:"verifying_at,omitempty" json:"verifying_at,omitempty" xml:"verifying_at,omitempty"`
	RollbackRequestedAt *string `form:"rollback_requested_at,omitempty" json:"rollback_requested_at,omitempty" xml:"rollback_requested_at,omitempty"`
	RollingBackAt       *string `form:"rolling_back_at,omitempty" json:"rolling_back_at,omitempty" xml:"rolling_back_at,omitempty"`
	TerminalAt          *string `form:"terminal_at,omitempty" json:"terminal_at,omitempty" xml:"terminal_at,omitempty"`
	UpdatedAt           *string `form:"updated_at,omitempty" json:"updated_at,omitempty" xml:"updated_at,omitempty"`
}

CancelResponseBody is the type of the "agentupgrades" service "cancel" endpoint HTTP response body.

type Client 

type Client struct {
	// Availability Doer is the HTTP client used to make requests to the
	// availability endpoint.
	AvailabilityDoer goahttp.Doer

	// Start Doer is the HTTP client used to make requests to the start endpoint.
	StartDoer goahttp.Doer

	// Status Doer is the HTTP client used to make requests to the status endpoint.
	StatusDoer goahttp.Doer

	// Cancel Doer is the HTTP client used to make requests to the cancel endpoint.
	CancelDoer goahttp.Doer

	// Rollback Doer is the HTTP client used to make requests to the rollback
	// endpoint.
	RollbackDoer goahttp.Doer

	// RestoreResponseBody controls whether the response bodies are reset after
	// decoding so they can be read again.
	RestoreResponseBody bool
	// contains filtered or unexported fields
}

Client lists the agentupgrades service endpoint HTTP clients.

func NewClient 

func NewClient(
	scheme string,
	host string,
	doer goahttp.Doer,
	enc func(*http.Request) goahttp.Encoder,
	dec func(*http.Response) goahttp.Decoder,
	restoreBody bool,
) *Client

NewClient instantiates HTTP clients for all the agentupgrades service servers.

func (*Client) Availability 

func (c *Client) Availability() goa.Endpoint

Availability returns an endpoint that makes HTTP requests to the agentupgrades service availability server.

func (*Client) BuildAvailabilityRequest 

func (c *Client) BuildAvailabilityRequest(ctx context.Context, v any) (*http.Request, error)

BuildAvailabilityRequest instantiates a HTTP request object with method and path set to call the "agentupgrades" service "availability" endpoint

func (*Client) BuildCancelRequest 

func (c *Client) BuildCancelRequest(ctx context.Context, v any) (*http.Request, error)

BuildCancelRequest instantiates a HTTP request object with method and path set to call the "agentupgrades" service "cancel" endpoint

func (*Client) BuildRollbackRequest 

func (c *Client) BuildRollbackRequest(ctx context.Context, v any) (*http.Request, error)

BuildRollbackRequest instantiates a HTTP request object with method and path set to call the "agentupgrades" service "rollback" endpoint

func (*Client) BuildStartRequest 

func (c *Client) BuildStartRequest(ctx context.Context, v any) (*http.Request, error)

BuildStartRequest instantiates a HTTP request object with method and path set to call the "agentupgrades" service "start" endpoint

func (*Client) BuildStatusRequest 

func (c *Client) BuildStatusRequest(ctx context.Context, v any) (*http.Request, error)

BuildStatusRequest instantiates a HTTP request object with method and path set to call the "agentupgrades" service "status" endpoint

func (*Client) Cancel 

func (c *Client) Cancel() goa.Endpoint

Cancel returns an endpoint that makes HTTP requests to the agentupgrades service cancel server.

func (*Client) Rollback 

func (c *Client) Rollback() goa.Endpoint

Rollback returns an endpoint that makes HTTP requests to the agentupgrades service rollback server.

func (*Client) Start 

func (c *Client) Start() goa.Endpoint

Start returns an endpoint that makes HTTP requests to the agentupgrades service start server.

func (*Client) Status 

func (c *Client) Status() goa.Endpoint

Status returns an endpoint that makes HTTP requests to the agentupgrades service status server.

type RollbackResponseBody 

type RollbackResponseBody struct {
	// Server-minted attempt identifier
	AttemptID     *string `form:"attempt_id,omitempty" json:"attempt_id,omitempty" xml:"attempt_id,omitempty"`
	Namespace     *string `form:"namespace,omitempty" json:"namespace,omitempty" xml:"namespace,omitempty"`
	WorkspaceName *string `form:"workspace_name,omitempty" json:"workspace_name,omitempty" xml:"workspace_name,omitempty"`
	WorkspaceUID  *string `form:"workspace_uid,omitempty" json:"workspace_uid,omitempty" xml:"workspace_uid,omitempty"`
	// Controller-owned VM UID the reservation is bound to
	VMUID *string `form:"vm_uid,omitempty" json:"vm_uid,omitempty" xml:"vm_uid,omitempty"`
	// UID of the administrator that admitted the attempt
	ActorID *string `form:"actor_id,omitempty" json:"actor_id,omitempty" xml:"actor_id,omitempty"`
	// Attempt lifecycle state
	State                            *string `form:"state,omitempty" json:"state,omitempty" xml:"state,omitempty"`
	TargetID                         *string `form:"target_id,omitempty" json:"target_id,omitempty" xml:"target_id,omitempty"`
	TargetManifestSha256             *string `form:"target_manifest_sha256,omitempty" json:"target_manifest_sha256,omitempty" xml:"target_manifest_sha256,omitempty"`
	ExpectedInstalledInventorySha256 *string `` /* 157-byte string literal not displayed */
	// Whether the admitted attempt may run the bounded reboot sequence
	AllowReboot *bool `form:"allow_reboot,omitempty" json:"allow_reboot,omitempty" xml:"allow_reboot,omitempty"`
	// An administrator requested safe-boundary cancellation
	CancelRequested *bool `form:"cancel_requested,omitempty" json:"cancel_requested,omitempty" xml:"cancel_requested,omitempty"`
	// Linked execution admission record (recording authorization)
	ExecutionID *string `form:"execution_id,omitempty" json:"execution_id,omitempty" xml:"execution_id,omitempty"`
	// Protected attempt recording
	RecordingID *string `form:"recording_id,omitempty" json:"recording_id,omitempty" xml:"recording_id,omitempty"`
	// Independently authorized recording link
	RecordingURL *string `form:"recording_url,omitempty" json:"recording_url,omitempty" xml:"recording_url,omitempty"`
	// Canonical status URL for this attempt
	StatusURL *string `form:"status_url,omitempty" json:"status_url,omitempty" xml:"status_url,omitempty"`
	// Last reconciled guest journal sequence
	JournalSequence *uint64 `form:"journal_sequence,omitempty" json:"journal_sequence,omitempty" xml:"journal_sequence,omitempty"`
	// Pinned rollback predecessor target
	PredecessorTargetID *string `form:"predecessor_target_id,omitempty" json:"predecessor_target_id,omitempty" xml:"predecessor_target_id,omitempty"`
	// Pinned rollback predecessor manifest digest
	PredecessorManifestSha256 *string `` /* 133-byte string literal not displayed */
	// Bounded machine-readable failure code
	ErrorCode *string `form:"error_code,omitempty" json:"error_code,omitempty" xml:"error_code,omitempty"`
	// RFC3339 admission timestamp
	AdmittedAt          *string `form:"admitted_at,omitempty" json:"admitted_at,omitempty" xml:"admitted_at,omitempty"`
	StagingAt           *string `form:"staging_at,omitempty" json:"staging_at,omitempty" xml:"staging_at,omitempty"`
	PreparedAt          *string `form:"prepared_at,omitempty" json:"prepared_at,omitempty" xml:"prepared_at,omitempty"`
	InstallingAt        *string `form:"installing_at,omitempty" json:"installing_at,omitempty" xml:"installing_at,omitempty"`
	AwaitingRebootAt    *string `form:"awaiting_reboot_at,omitempty" json:"awaiting_reboot_at,omitempty" xml:"awaiting_reboot_at,omitempty"`
	VerifyingAt         *string `form:"verifying_at,omitempty" json:"verifying_at,omitempty" xml:"verifying_at,omitempty"`
	RollbackRequestedAt *string `form:"rollback_requested_at,omitempty" json:"rollback_requested_at,omitempty" xml:"rollback_requested_at,omitempty"`
	RollingBackAt       *string `form:"rolling_back_at,omitempty" json:"rolling_back_at,omitempty" xml:"rolling_back_at,omitempty"`
	TerminalAt          *string `form:"terminal_at,omitempty" json:"terminal_at,omitempty" xml:"terminal_at,omitempty"`
	UpdatedAt           *string `form:"updated_at,omitempty" json:"updated_at,omitempty" xml:"updated_at,omitempty"`
}

RollbackResponseBody is the type of the "agentupgrades" service "rollback" endpoint HTTP response body.

type StartRequestBody 

type StartRequestBody struct {
	// Operator-approved immutable target
	TargetID string `form:"target_id" json:"target_id" xml:"target_id"`
	// Expected signed manifest digest for the target
	TargetManifestSha256 string `form:"target_manifest_sha256" json:"target_manifest_sha256" xml:"target_manifest_sha256"`
	// Client-observed VM UID; must match the current controller-owned UID
	ExpectedVMUID string `form:"expected_vm_uid" json:"expected_vm_uid" xml:"expected_vm_uid"`
	// Client-observed execution revocation epoch
	ExpectedRevocationEpoch uint64 `form:"expected_revocation_epoch" json:"expected_revocation_epoch" xml:"expected_revocation_epoch"`
	// Client-observed installed inventory digest (re-verified before install)
	ExpectedInstalledInventorySha256 string `` /* 127-byte string literal not displayed */
	// Client-chosen key; an identical replay returns the original attempt
	IdempotencyKey string `form:"idempotency_key" json:"idempotency_key" xml:"idempotency_key"`
	// Permit the recorded bounded reboot sequence
	AllowReboot bool `form:"allow_reboot" json:"allow_reboot" xml:"allow_reboot"`
}

StartRequestBody is the type of the "agentupgrades" service "start" endpoint HTTP request body.

func NewStartRequestBody 

func NewStartRequestBody(p *agentupgrades.AgentUpgradeStartPayload) *StartRequestBody

NewStartRequestBody builds the HTTP request body from the payload of the "start" endpoint of the "agentupgrades" service.

type StartResponseBody 

type StartResponseBody struct {
	// Server-minted attempt identifier
	AttemptID     *string `form:"attempt_id,omitempty" json:"attempt_id,omitempty" xml:"attempt_id,omitempty"`
	Namespace     *string `form:"namespace,omitempty" json:"namespace,omitempty" xml:"namespace,omitempty"`
	WorkspaceName *string `form:"workspace_name,omitempty" json:"workspace_name,omitempty" xml:"workspace_name,omitempty"`
	WorkspaceUID  *string `form:"workspace_uid,omitempty" json:"workspace_uid,omitempty" xml:"workspace_uid,omitempty"`
	// Controller-owned VM UID the reservation is bound to
	VMUID *string `form:"vm_uid,omitempty" json:"vm_uid,omitempty" xml:"vm_uid,omitempty"`
	// UID of the administrator that admitted the attempt
	ActorID *string `form:"actor_id,omitempty" json:"actor_id,omitempty" xml:"actor_id,omitempty"`
	// Attempt lifecycle state
	State                            *string `form:"state,omitempty" json:"state,omitempty" xml:"state,omitempty"`
	TargetID                         *string `form:"target_id,omitempty" json:"target_id,omitempty" xml:"target_id,omitempty"`
	TargetManifestSha256             *string `form:"target_manifest_sha256,omitempty" json:"target_manifest_sha256,omitempty" xml:"target_manifest_sha256,omitempty"`
	ExpectedInstalledInventorySha256 *string `` /* 157-byte string literal not displayed */
	// Whether the admitted attempt may run the bounded reboot sequence
	AllowReboot *bool `form:"allow_reboot,omitempty" json:"allow_reboot,omitempty" xml:"allow_reboot,omitempty"`
	// An administrator requested safe-boundary cancellation
	CancelRequested *bool `form:"cancel_requested,omitempty" json:"cancel_requested,omitempty" xml:"cancel_requested,omitempty"`
	// Linked execution admission record (recording authorization)
	ExecutionID *string `form:"execution_id,omitempty" json:"execution_id,omitempty" xml:"execution_id,omitempty"`
	// Protected attempt recording
	RecordingID *string `form:"recording_id,omitempty" json:"recording_id,omitempty" xml:"recording_id,omitempty"`
	// Independently authorized recording link
	RecordingURL *string `form:"recording_url,omitempty" json:"recording_url,omitempty" xml:"recording_url,omitempty"`
	// Canonical status URL for this attempt
	StatusURL *string `form:"status_url,omitempty" json:"status_url,omitempty" xml:"status_url,omitempty"`
	// Last reconciled guest journal sequence
	JournalSequence *uint64 `form:"journal_sequence,omitempty" json:"journal_sequence,omitempty" xml:"journal_sequence,omitempty"`
	// Pinned rollback predecessor target
	PredecessorTargetID *string `form:"predecessor_target_id,omitempty" json:"predecessor_target_id,omitempty" xml:"predecessor_target_id,omitempty"`
	// Pinned rollback predecessor manifest digest
	PredecessorManifestSha256 *string `` /* 133-byte string literal not displayed */
	// Bounded machine-readable failure code
	ErrorCode *string `form:"error_code,omitempty" json:"error_code,omitempty" xml:"error_code,omitempty"`
	// RFC3339 admission timestamp
	AdmittedAt          *string `form:"admitted_at,omitempty" json:"admitted_at,omitempty" xml:"admitted_at,omitempty"`
	StagingAt           *string `form:"staging_at,omitempty" json:"staging_at,omitempty" xml:"staging_at,omitempty"`
	PreparedAt          *string `form:"prepared_at,omitempty" json:"prepared_at,omitempty" xml:"prepared_at,omitempty"`
	InstallingAt        *string `form:"installing_at,omitempty" json:"installing_at,omitempty" xml:"installing_at,omitempty"`
	AwaitingRebootAt    *string `form:"awaiting_reboot_at,omitempty" json:"awaiting_reboot_at,omitempty" xml:"awaiting_reboot_at,omitempty"`
	VerifyingAt         *string `form:"verifying_at,omitempty" json:"verifying_at,omitempty" xml:"verifying_at,omitempty"`
	RollbackRequestedAt *string `form:"rollback_requested_at,omitempty" json:"rollback_requested_at,omitempty" xml:"rollback_requested_at,omitempty"`
	RollingBackAt       *string `form:"rolling_back_at,omitempty" json:"rolling_back_at,omitempty" xml:"rolling_back_at,omitempty"`
	TerminalAt          *string `form:"terminal_at,omitempty" json:"terminal_at,omitempty" xml:"terminal_at,omitempty"`
	UpdatedAt           *string `form:"updated_at,omitempty" json:"updated_at,omitempty" xml:"updated_at,omitempty"`
}

StartResponseBody is the type of the "agentupgrades" service "start" endpoint HTTP response body.

type StatusResponseBody 

type StatusResponseBody struct {
	// Server-minted attempt identifier
	AttemptID     *string `form:"attempt_id,omitempty" json:"attempt_id,omitempty" xml:"attempt_id,omitempty"`
	Namespace     *string `form:"namespace,omitempty" json:"namespace,omitempty" xml:"namespace,omitempty"`
	WorkspaceName *string `form:"workspace_name,omitempty" json:"workspace_name,omitempty" xml:"workspace_name,omitempty"`
	WorkspaceUID  *string `form:"workspace_uid,omitempty" json:"workspace_uid,omitempty" xml:"workspace_uid,omitempty"`
	// Controller-owned VM UID the reservation is bound to
	VMUID *string `form:"vm_uid,omitempty" json:"vm_uid,omitempty" xml:"vm_uid,omitempty"`
	// UID of the administrator that admitted the attempt
	ActorID *string `form:"actor_id,omitempty" json:"actor_id,omitempty" xml:"actor_id,omitempty"`
	// Attempt lifecycle state
	State                            *string `form:"state,omitempty" json:"state,omitempty" xml:"state,omitempty"`
	TargetID                         *string `form:"target_id,omitempty" json:"target_id,omitempty" xml:"target_id,omitempty"`
	TargetManifestSha256             *string `form:"target_manifest_sha256,omitempty" json:"target_manifest_sha256,omitempty" xml:"target_manifest_sha256,omitempty"`
	ExpectedInstalledInventorySha256 *string `` /* 157-byte string literal not displayed */
	// Whether the admitted attempt may run the bounded reboot sequence
	AllowReboot *bool `form:"allow_reboot,omitempty" json:"allow_reboot,omitempty" xml:"allow_reboot,omitempty"`
	// An administrator requested safe-boundary cancellation
	CancelRequested *bool `form:"cancel_requested,omitempty" json:"cancel_requested,omitempty" xml:"cancel_requested,omitempty"`
	// Linked execution admission record (recording authorization)
	ExecutionID *string `form:"execution_id,omitempty" json:"execution_id,omitempty" xml:"execution_id,omitempty"`
	// Protected attempt recording
	RecordingID *string `form:"recording_id,omitempty" json:"recording_id,omitempty" xml:"recording_id,omitempty"`
	// Independently authorized recording link
	RecordingURL *string `form:"recording_url,omitempty" json:"recording_url,omitempty" xml:"recording_url,omitempty"`
	// Canonical status URL for this attempt
	StatusURL *string `form:"status_url,omitempty" json:"status_url,omitempty" xml:"status_url,omitempty"`
	// Last reconciled guest journal sequence
	JournalSequence *uint64 `form:"journal_sequence,omitempty" json:"journal_sequence,omitempty" xml:"journal_sequence,omitempty"`
	// Pinned rollback predecessor target
	PredecessorTargetID *string `form:"predecessor_target_id,omitempty" json:"predecessor_target_id,omitempty" xml:"predecessor_target_id,omitempty"`
	// Pinned rollback predecessor manifest digest
	PredecessorManifestSha256 *string `` /* 133-byte string literal not displayed */
	// Bounded machine-readable failure code
	ErrorCode *string `form:"error_code,omitempty" json:"error_code,omitempty" xml:"error_code,omitempty"`
	// RFC3339 admission timestamp
	AdmittedAt          *string `form:"admitted_at,omitempty" json:"admitted_at,omitempty" xml:"admitted_at,omitempty"`
	StagingAt           *string `form:"staging_at,omitempty" json:"staging_at,omitempty" xml:"staging_at,omitempty"`
	PreparedAt          *string `form:"prepared_at,omitempty" json:"prepared_at,omitempty" xml:"prepared_at,omitempty"`
	InstallingAt        *string `form:"installing_at,omitempty" json:"installing_at,omitempty" xml:"installing_at,omitempty"`
	AwaitingRebootAt    *string `form:"awaiting_reboot_at,omitempty" json:"awaiting_reboot_at,omitempty" xml:"awaiting_reboot_at,omitempty"`
	VerifyingAt         *string `form:"verifying_at,omitempty" json:"verifying_at,omitempty" xml:"verifying_at,omitempty"`
	RollbackRequestedAt *string `form:"rollback_requested_at,omitempty" json:"rollback_requested_at,omitempty" xml:"rollback_requested_at,omitempty"`
	RollingBackAt       *string `form:"rolling_back_at,omitempty" json:"rolling_back_at,omitempty" xml:"rolling_back_at,omitempty"`
	TerminalAt          *string `form:"terminal_at,omitempty" json:"terminal_at,omitempty" xml:"terminal_at,omitempty"`
	UpdatedAt           *string `form:"updated_at,omitempty" json:"updated_at,omitempty" xml:"updated_at,omitempty"`
}

StatusResponseBody is the type of the "agentupgrades" service "status" endpoint HTTP response body.

Source Files

View all Source files

Jump to

Keyboard shortcuts

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