updateruns

package
v0.20231212.1202820 Latest Latest
Warning

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

Go to latest
Published: Dec 12, 2023 License: MPL-2.0 Imports: 12 Imported by: 1

README

github.com/hashicorp/go-azure-sdk/resource-manager/containerservice/2023-10-15/updateruns Documentation

The updateruns SDK allows for interaction with the Azure Resource Manager Service containerservice (API Version 2023-10-15).

This readme covers example usages, but further information on using this SDK can be found in the project root.

Import Path

import "github.com/hashicorp/go-azure-sdk/resource-manager/containerservice/2023-10-15/updateruns"

Client Initialization

client := updateruns.NewUpdateRunsClientWithBaseURI("https://management.azure.com")
client.Client.Authorizer = authorizer

Example Usage: UpdateRunsClient.CreateOrUpdate

ctx := context.TODO()
id := updateruns.NewUpdateRunID("12345678-1234-9876-4563-123456789012", "example-resource-group", "fleetValue", "updateRunValue")

payload := updateruns.UpdateRun{
	// ...
}


if err := client.CreateOrUpdateThenPoll(ctx, id, payload, updateruns.DefaultCreateOrUpdateOperationOptions()); err != nil {
	// handle the error
}

Example Usage: UpdateRunsClient.Delete

ctx := context.TODO()
id := updateruns.NewUpdateRunID("12345678-1234-9876-4563-123456789012", "example-resource-group", "fleetValue", "updateRunValue")

if err := client.DeleteThenPoll(ctx, id, updateruns.DefaultDeleteOperationOptions()); err != nil {
	// handle the error
}

Example Usage: UpdateRunsClient.Get

ctx := context.TODO()
id := updateruns.NewUpdateRunID("12345678-1234-9876-4563-123456789012", "example-resource-group", "fleetValue", "updateRunValue")

read, err := client.Get(ctx, id)
if err != nil {
	// handle the error
}
if model := read.Model; model != nil {
	// do something with the model/response object
}

Example Usage: UpdateRunsClient.ListByFleet

ctx := context.TODO()
id := updateruns.NewFleetID("12345678-1234-9876-4563-123456789012", "example-resource-group", "fleetValue")

// alternatively `client.ListByFleet(ctx, id)` can be used to do batched pagination
items, err := client.ListByFleetComplete(ctx, id)
if err != nil {
	// handle the error
}
for _, item := range items {
	// do something
}

Example Usage: UpdateRunsClient.Start

ctx := context.TODO()
id := updateruns.NewUpdateRunID("12345678-1234-9876-4563-123456789012", "example-resource-group", "fleetValue", "updateRunValue")

if err := client.StartThenPoll(ctx, id, updateruns.DefaultStartOperationOptions()); err != nil {
	// handle the error
}

Example Usage: UpdateRunsClient.Stop

ctx := context.TODO()
id := updateruns.NewUpdateRunID("12345678-1234-9876-4563-123456789012", "example-resource-group", "fleetValue", "updateRunValue")

if err := client.StopThenPoll(ctx, id, updateruns.DefaultStopOperationOptions()); err != nil {
	// handle the error
}

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func PossibleValuesForManagedClusterUpgradeType

func PossibleValuesForManagedClusterUpgradeType() []string

func PossibleValuesForNodeImageSelectionType

func PossibleValuesForNodeImageSelectionType() []string

func PossibleValuesForUpdateRunProvisioningState

func PossibleValuesForUpdateRunProvisioningState() []string

func PossibleValuesForUpdateState

func PossibleValuesForUpdateState() []string

func ValidateFleetID

func ValidateFleetID(input interface{}, key string) (warnings []string, errors []error)

ValidateFleetID checks that 'input' can be parsed as a Fleet ID

func ValidateUpdateRunID

func ValidateUpdateRunID(input interface{}, key string) (warnings []string, errors []error)

ValidateUpdateRunID checks that 'input' can be parsed as a Update Run ID

Types

type CreateOrUpdateOperationOptions

type CreateOrUpdateOperationOptions struct {
	IfMatch     *string
	IfNoneMatch *string
}

func DefaultCreateOrUpdateOperationOptions

func DefaultCreateOrUpdateOperationOptions() CreateOrUpdateOperationOptions

type CreateOrUpdateOperationResponse

type CreateOrUpdateOperationResponse struct {
	Poller       polling.LongRunningPoller
	HttpResponse *http.Response
}

type DeleteOperationOptions

type DeleteOperationOptions struct {
	IfMatch *string
}

func DefaultDeleteOperationOptions

func DefaultDeleteOperationOptions() DeleteOperationOptions

type DeleteOperationResponse

type DeleteOperationResponse struct {
	Poller       polling.LongRunningPoller
	HttpResponse *http.Response
}

type ErrorAdditionalInfo

type ErrorAdditionalInfo struct {
	Info *interface{} `json:"info,omitempty"`
	Type *string      `json:"type,omitempty"`
}

type ErrorDetail

type ErrorDetail struct {
	AdditionalInfo *[]ErrorAdditionalInfo `json:"additionalInfo,omitempty"`
	Code           *string                `json:"code,omitempty"`
	Details        *[]ErrorDetail         `json:"details,omitempty"`
	Message        *string                `json:"message,omitempty"`
	Target         *string                `json:"target,omitempty"`
}

type FleetId

type FleetId struct {
	SubscriptionId    string
	ResourceGroupName string
	FleetName         string
}

FleetId is a struct representing the Resource ID for a Fleet

func NewFleetID

func NewFleetID(subscriptionId string, resourceGroupName string, fleetName string) FleetId

NewFleetID returns a new FleetId struct

func ParseFleetID

func ParseFleetID(input string) (*FleetId, error)

ParseFleetID parses 'input' into a FleetId

func ParseFleetIDInsensitively

func ParseFleetIDInsensitively(input string) (*FleetId, error)

ParseFleetIDInsensitively parses 'input' case-insensitively into a FleetId note: this method should only be used for API response data and not user input

func (*FleetId) FromParseResult added in v0.20231127.1171502

func (id *FleetId) FromParseResult(input resourceids.ParseResult) error

func (FleetId) ID

func (id FleetId) ID() string

ID returns the formatted Fleet ID

func (FleetId) Segments

func (id FleetId) Segments() []resourceids.Segment

Segments returns a slice of Resource ID Segments which comprise this Fleet ID

func (FleetId) String

func (id FleetId) String() string

String returns a human-readable description of this Fleet ID

type GetOperationResponse

type GetOperationResponse struct {
	HttpResponse *http.Response
	Model        *UpdateRun
}

type ListByFleetCompleteResult

type ListByFleetCompleteResult struct {
	Items []UpdateRun
}

type ListByFleetOperationResponse

type ListByFleetOperationResponse struct {
	HttpResponse *http.Response
	Model        *[]UpdateRun
	// contains filtered or unexported fields
}

func (ListByFleetOperationResponse) HasMore

func (r ListByFleetOperationResponse) HasMore() bool

func (ListByFleetOperationResponse) LoadMore

type ManagedClusterUpdate

type ManagedClusterUpdate struct {
	NodeImageSelection *NodeImageSelection       `json:"nodeImageSelection,omitempty"`
	Upgrade            ManagedClusterUpgradeSpec `json:"upgrade"`
}

type ManagedClusterUpgradeSpec

type ManagedClusterUpgradeSpec struct {
	KubernetesVersion *string                   `json:"kubernetesVersion,omitempty"`
	Type              ManagedClusterUpgradeType `json:"type"`
}

type ManagedClusterUpgradeType

type ManagedClusterUpgradeType string
const (
	ManagedClusterUpgradeTypeFull          ManagedClusterUpgradeType = "Full"
	ManagedClusterUpgradeTypeNodeImageOnly ManagedClusterUpgradeType = "NodeImageOnly"
)

type MemberUpdateStatus

type MemberUpdateStatus struct {
	ClusterResourceId *string       `json:"clusterResourceId,omitempty"`
	Message           *string       `json:"message,omitempty"`
	Name              *string       `json:"name,omitempty"`
	OperationId       *string       `json:"operationId,omitempty"`
	Status            *UpdateStatus `json:"status,omitempty"`
}

type NodeImageSelection

type NodeImageSelection struct {
	Type NodeImageSelectionType `json:"type"`
}

type NodeImageSelectionStatus

type NodeImageSelectionStatus struct {
	SelectedNodeImageVersions *[]NodeImageVersion `json:"selectedNodeImageVersions,omitempty"`
}

type NodeImageSelectionType

type NodeImageSelectionType string
const (
	NodeImageSelectionTypeConsistent NodeImageSelectionType = "Consistent"
	NodeImageSelectionTypeLatest     NodeImageSelectionType = "Latest"
)

type NodeImageVersion

type NodeImageVersion struct {
	Version *string `json:"version,omitempty"`
}

type StartOperationOptions

type StartOperationOptions struct {
	IfMatch *string
}

func DefaultStartOperationOptions

func DefaultStartOperationOptions() StartOperationOptions

type StartOperationResponse

type StartOperationResponse struct {
	Poller       polling.LongRunningPoller
	HttpResponse *http.Response
}

type StopOperationOptions

type StopOperationOptions struct {
	IfMatch *string
}

func DefaultStopOperationOptions

func DefaultStopOperationOptions() StopOperationOptions

type StopOperationResponse

type StopOperationResponse struct {
	Poller       polling.LongRunningPoller
	HttpResponse *http.Response
}

type UpdateGroup

type UpdateGroup struct {
	Name string `json:"name"`
}

type UpdateGroupStatus

type UpdateGroupStatus struct {
	Members *[]MemberUpdateStatus `json:"members,omitempty"`
	Name    *string               `json:"name,omitempty"`
	Status  *UpdateStatus         `json:"status,omitempty"`
}

type UpdateRun

type UpdateRun struct {
	ETag       *string                `json:"eTag,omitempty"`
	Id         *string                `json:"id,omitempty"`
	Name       *string                `json:"name,omitempty"`
	Properties *UpdateRunProperties   `json:"properties,omitempty"`
	SystemData *systemdata.SystemData `json:"systemData,omitempty"`
	Type       *string                `json:"type,omitempty"`
}

type UpdateRunId

type UpdateRunId struct {
	SubscriptionId    string
	ResourceGroupName string
	FleetName         string
	UpdateRunName     string
}

UpdateRunId is a struct representing the Resource ID for a Update Run

func NewUpdateRunID

func NewUpdateRunID(subscriptionId string, resourceGroupName string, fleetName string, updateRunName string) UpdateRunId

NewUpdateRunID returns a new UpdateRunId struct

func ParseUpdateRunID

func ParseUpdateRunID(input string) (*UpdateRunId, error)

ParseUpdateRunID parses 'input' into a UpdateRunId

func ParseUpdateRunIDInsensitively

func ParseUpdateRunIDInsensitively(input string) (*UpdateRunId, error)

ParseUpdateRunIDInsensitively parses 'input' case-insensitively into a UpdateRunId note: this method should only be used for API response data and not user input

func (*UpdateRunId) FromParseResult added in v0.20231127.1171502

func (id *UpdateRunId) FromParseResult(input resourceids.ParseResult) error

func (UpdateRunId) ID

func (id UpdateRunId) ID() string

ID returns the formatted Update Run ID

func (UpdateRunId) Segments

func (id UpdateRunId) Segments() []resourceids.Segment

Segments returns a slice of Resource ID Segments which comprise this Update Run ID

func (UpdateRunId) String

func (id UpdateRunId) String() string

String returns a human-readable description of this Update Run ID

type UpdateRunOperationPredicate

type UpdateRunOperationPredicate struct {
	ETag *string
	Id   *string
	Name *string
	Type *string
}

func (UpdateRunOperationPredicate) Matches

func (p UpdateRunOperationPredicate) Matches(input UpdateRun) bool

type UpdateRunProperties

type UpdateRunProperties struct {
	ManagedClusterUpdate ManagedClusterUpdate        `json:"managedClusterUpdate"`
	ProvisioningState    *UpdateRunProvisioningState `json:"provisioningState,omitempty"`
	Status               *UpdateRunStatus            `json:"status,omitempty"`
	Strategy             *UpdateRunStrategy          `json:"strategy,omitempty"`
	UpdateStrategyId     *string                     `json:"updateStrategyId,omitempty"`
}

type UpdateRunProvisioningState

type UpdateRunProvisioningState string
const (
	UpdateRunProvisioningStateCanceled  UpdateRunProvisioningState = "Canceled"
	UpdateRunProvisioningStateFailed    UpdateRunProvisioningState = "Failed"
	UpdateRunProvisioningStateSucceeded UpdateRunProvisioningState = "Succeeded"
)

type UpdateRunStatus

type UpdateRunStatus struct {
	NodeImageSelection *NodeImageSelectionStatus `json:"nodeImageSelection,omitempty"`
	Stages             *[]UpdateStageStatus      `json:"stages,omitempty"`
	Status             *UpdateStatus             `json:"status,omitempty"`
}

type UpdateRunStrategy

type UpdateRunStrategy struct {
	Stages []UpdateStage `json:"stages"`
}

type UpdateRunsClient

type UpdateRunsClient struct {
	Client autorest.Client
	// contains filtered or unexported fields
}

func NewUpdateRunsClientWithBaseURI

func NewUpdateRunsClientWithBaseURI(endpoint string) UpdateRunsClient

func (UpdateRunsClient) CreateOrUpdate

CreateOrUpdate ...

func (UpdateRunsClient) CreateOrUpdateThenPoll

func (c UpdateRunsClient) CreateOrUpdateThenPoll(ctx context.Context, id UpdateRunId, input UpdateRun, options CreateOrUpdateOperationOptions) error

CreateOrUpdateThenPoll performs CreateOrUpdate then polls until it's completed

func (UpdateRunsClient) Delete

Delete ...

func (UpdateRunsClient) DeleteThenPoll

func (c UpdateRunsClient) DeleteThenPoll(ctx context.Context, id UpdateRunId, options DeleteOperationOptions) error

DeleteThenPoll performs Delete then polls until it's completed

func (UpdateRunsClient) Get

Get ...

func (UpdateRunsClient) ListByFleet

func (c UpdateRunsClient) ListByFleet(ctx context.Context, id FleetId) (resp ListByFleetOperationResponse, err error)

ListByFleet ...

func (UpdateRunsClient) ListByFleetComplete

func (c UpdateRunsClient) ListByFleetComplete(ctx context.Context, id FleetId) (ListByFleetCompleteResult, error)

ListByFleetComplete retrieves all of the results into a single object

func (UpdateRunsClient) ListByFleetCompleteMatchingPredicate

func (c UpdateRunsClient) ListByFleetCompleteMatchingPredicate(ctx context.Context, id FleetId, predicate UpdateRunOperationPredicate) (resp ListByFleetCompleteResult, err error)

ListByFleetCompleteMatchingPredicate retrieves all of the results and then applied the predicate

func (UpdateRunsClient) Start

Start ...

func (UpdateRunsClient) StartThenPoll

func (c UpdateRunsClient) StartThenPoll(ctx context.Context, id UpdateRunId, options StartOperationOptions) error

StartThenPoll performs Start then polls until it's completed

func (UpdateRunsClient) Stop

Stop ...

func (UpdateRunsClient) StopThenPoll

func (c UpdateRunsClient) StopThenPoll(ctx context.Context, id UpdateRunId, options StopOperationOptions) error

StopThenPoll performs Stop then polls until it's completed

type UpdateStage

type UpdateStage struct {
	AfterStageWaitInSeconds *int64         `json:"afterStageWaitInSeconds,omitempty"`
	Groups                  *[]UpdateGroup `json:"groups,omitempty"`
	Name                    string         `json:"name"`
}

type UpdateStageStatus

type UpdateStageStatus struct {
	AfterStageWaitStatus *WaitStatus          `json:"afterStageWaitStatus,omitempty"`
	Groups               *[]UpdateGroupStatus `json:"groups,omitempty"`
	Name                 *string              `json:"name,omitempty"`
	Status               *UpdateStatus        `json:"status,omitempty"`
}

type UpdateState

type UpdateState string
const (
	UpdateStateCompleted  UpdateState = "Completed"
	UpdateStateFailed     UpdateState = "Failed"
	UpdateStateNotStarted UpdateState = "NotStarted"
	UpdateStateRunning    UpdateState = "Running"
	UpdateStateSkipped    UpdateState = "Skipped"
	UpdateStateStopped    UpdateState = "Stopped"
	UpdateStateStopping   UpdateState = "Stopping"
)

type UpdateStatus

type UpdateStatus struct {
	CompletedTime *string      `json:"completedTime,omitempty"`
	Error         *ErrorDetail `json:"error,omitempty"`
	StartTime     *string      `json:"startTime,omitempty"`
	State         *UpdateState `json:"state,omitempty"`
}

func (*UpdateStatus) GetCompletedTimeAsTime

func (o *UpdateStatus) GetCompletedTimeAsTime() (*time.Time, error)

func (*UpdateStatus) GetStartTimeAsTime

func (o *UpdateStatus) GetStartTimeAsTime() (*time.Time, error)

func (*UpdateStatus) SetCompletedTimeAsTime

func (o *UpdateStatus) SetCompletedTimeAsTime(input time.Time)

func (*UpdateStatus) SetStartTimeAsTime

func (o *UpdateStatus) SetStartTimeAsTime(input time.Time)

type WaitStatus

type WaitStatus struct {
	Status                *UpdateStatus `json:"status,omitempty"`
	WaitDurationInSeconds *int64        `json:"waitDurationInSeconds,omitempty"`
}

Jump to

Keyboard shortcuts

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