workspaces

package
v1.1.8 Latest Latest
Warning

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

Go to latest
Published: Mar 3, 2016 License: Apache-2.0 Imports: 6 Imported by: 0

Documentation

Overview

Package workspaces provides a client for Amazon WorkSpaces.

Index

Examples

Constants

View Source
const (
	// @enum Compute
	ComputeValue = "VALUE"
	// @enum Compute
	ComputeStandard = "STANDARD"
	// @enum Compute
	ComputePerformance = "PERFORMANCE"
)
View Source
const (
	// @enum WorkspaceDirectoryState
	WorkspaceDirectoryStateRegistering = "REGISTERING"
	// @enum WorkspaceDirectoryState
	WorkspaceDirectoryStateRegistered = "REGISTERED"
	// @enum WorkspaceDirectoryState
	WorkspaceDirectoryStateDeregistering = "DEREGISTERING"
	// @enum WorkspaceDirectoryState
	WorkspaceDirectoryStateDeregistered = "DEREGISTERED"
	// @enum WorkspaceDirectoryState
	WorkspaceDirectoryStateError = "ERROR"
)
View Source
const (
	// @enum WorkspaceDirectoryType
	WorkspaceDirectoryTypeSimpleAd = "SIMPLE_AD"
	// @enum WorkspaceDirectoryType
	WorkspaceDirectoryTypeAdConnector = "AD_CONNECTOR"
)
View Source
const (
	// @enum WorkspaceState
	WorkspaceStatePending = "PENDING"
	// @enum WorkspaceState
	WorkspaceStateAvailable = "AVAILABLE"
	// @enum WorkspaceState
	WorkspaceStateImpaired = "IMPAIRED"
	// @enum WorkspaceState
	WorkspaceStateUnhealthy = "UNHEALTHY"
	// @enum WorkspaceState
	WorkspaceStateRebooting = "REBOOTING"
	// @enum WorkspaceState
	WorkspaceStateRebuilding = "REBUILDING"
	// @enum WorkspaceState
	WorkspaceStateTerminating = "TERMINATING"
	// @enum WorkspaceState
	WorkspaceStateTerminated = "TERMINATED"
	// @enum WorkspaceState
	WorkspaceStateSuspended = "SUSPENDED"
	// @enum WorkspaceState
	WorkspaceStateError = "ERROR"
)
View Source
const ServiceName = "workspaces"

A ServiceName is the name of the service the client will make API calls to.

Variables

This section is empty.

Functions

This section is empty.

Types

type ComputeType

type ComputeType struct {

	// The name of the compute type for the bundle.
	Name *string `type:"string" enum:"Compute"`
	// contains filtered or unexported fields
}

Contains information about the compute type of a WorkSpace bundle.

func (ComputeType) GoString added in v0.6.5

func (s ComputeType) GoString() string

GoString returns the string representation

func (ComputeType) String added in v0.6.5

func (s ComputeType) String() string

String returns the string representation

type CreateWorkspacesInput

type CreateWorkspacesInput struct {

	// An array of structures that specify the WorkSpaces to create.
	Workspaces []*WorkspaceRequest `min:"1" type:"list" required:"true"`
	// contains filtered or unexported fields
}

Contains the inputs for the CreateWorkspaces operation.

func (CreateWorkspacesInput) GoString added in v0.6.5

func (s CreateWorkspacesInput) GoString() string

GoString returns the string representation

func (CreateWorkspacesInput) String added in v0.6.5

func (s CreateWorkspacesInput) String() string

String returns the string representation

type CreateWorkspacesOutput

type CreateWorkspacesOutput struct {

	// An array of structures that represent the WorkSpaces that could not be created.
	FailedRequests []*FailedCreateWorkspaceRequest `type:"list"`

	// An array of structures that represent the WorkSpaces that were created.
	//
	// Because this operation is asynchronous, the identifier in WorkspaceId is
	// not immediately available. If you immediately call DescribeWorkspaces with
	// this identifier, no information will be returned.
	PendingRequests []*Workspace `type:"list"`
	// contains filtered or unexported fields
}

Contains the result of the CreateWorkspaces operation.

func (CreateWorkspacesOutput) GoString added in v0.6.5

func (s CreateWorkspacesOutput) GoString() string

GoString returns the string representation

func (CreateWorkspacesOutput) String added in v0.6.5

func (s CreateWorkspacesOutput) String() string

String returns the string representation

type DefaultWorkspaceCreationProperties

type DefaultWorkspaceCreationProperties struct {

	// The identifier of any custom security groups that are applied to the WorkSpaces
	// when they are created.
	CustomSecurityGroupId *string `type:"string"`

	// The organizational unit (OU) in the directory that the WorkSpace machine
	// accounts are placed in.
	DefaultOu *string `type:"string"`

	// A public IP address will be attached to all WorkSpaces that are created or
	// rebuilt.
	EnableInternetAccess *bool `type:"boolean"`

	// Specifies if the directory is enabled for Amazon WorkDocs.
	EnableWorkDocs *bool `type:"boolean"`

	// The WorkSpace user is an administrator on the WorkSpace.
	UserEnabledAsLocalAdministrator *bool `type:"boolean"`
	// contains filtered or unexported fields
}

Contains default WorkSpace creation information.

func (DefaultWorkspaceCreationProperties) GoString added in v0.6.5

GoString returns the string representation

func (DefaultWorkspaceCreationProperties) String added in v0.6.5

String returns the string representation

type DescribeWorkspaceBundlesInput

type DescribeWorkspaceBundlesInput struct {

	// An array of strings that contains the identifiers of the bundles to retrieve.
	// This parameter cannot be combined with any other filter parameter.
	BundleIds []*string `min:"1" type:"list"`

	// The NextToken value from a previous call to this operation. Pass null if
	// this is the first call.
	NextToken *string `min:"1" type:"string"`

	// The owner of the bundles to retrieve. This parameter cannot be combined with
	// any other filter parameter.
	//
	// This contains one of the following values:
	//
	//  null - Retrieves the bundles that belong to the account making the call.
	//  AMAZON - Retrieves the bundles that are provided by AWS.
	Owner *string `type:"string"`
	// contains filtered or unexported fields
}

Contains the inputs for the DescribeWorkspaceBundles operation.

func (DescribeWorkspaceBundlesInput) GoString added in v0.6.5

GoString returns the string representation

func (DescribeWorkspaceBundlesInput) String added in v0.6.5

String returns the string representation

type DescribeWorkspaceBundlesOutput

type DescribeWorkspaceBundlesOutput struct {

	// An array of structures that contain information about the bundles.
	Bundles []*WorkspaceBundle `type:"list"`

	// If not null, more results are available. Pass this value for the NextToken
	// parameter in a subsequent call to this operation to retrieve the next set
	// of items. This token is valid for one day and must be used within that timeframe.
	NextToken *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Contains the results of the DescribeWorkspaceBundles operation.

func (DescribeWorkspaceBundlesOutput) GoString added in v0.6.5

GoString returns the string representation

func (DescribeWorkspaceBundlesOutput) String added in v0.6.5

String returns the string representation

type DescribeWorkspaceDirectoriesInput

type DescribeWorkspaceDirectoriesInput struct {

	// An array of strings that contains the directory identifiers to retrieve information
	// for. If this member is null, all directories are retrieved.
	DirectoryIds []*string `min:"1" type:"list"`

	// The NextToken value from a previous call to this operation. Pass null if
	// this is the first call.
	NextToken *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Contains the inputs for the DescribeWorkspaceDirectories operation.

func (DescribeWorkspaceDirectoriesInput) GoString added in v0.6.5

GoString returns the string representation

func (DescribeWorkspaceDirectoriesInput) String added in v0.6.5

String returns the string representation

type DescribeWorkspaceDirectoriesOutput

type DescribeWorkspaceDirectoriesOutput struct {

	// An array of structures that contain information about the directories.
	Directories []*WorkspaceDirectory `type:"list"`

	// If not null, more results are available. Pass this value for the NextToken
	// parameter in a subsequent call to this operation to retrieve the next set
	// of items. This token is valid for one day and must be used within that timeframe.
	NextToken *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Contains the results of the DescribeWorkspaceDirectories operation.

func (DescribeWorkspaceDirectoriesOutput) GoString added in v0.6.5

GoString returns the string representation

func (DescribeWorkspaceDirectoriesOutput) String added in v0.6.5

String returns the string representation

type DescribeWorkspacesInput

type DescribeWorkspacesInput struct {

	// The identifier of a bundle to obtain the WorkSpaces for. All WorkSpaces that
	// are created from this bundle will be retrieved. This parameter cannot be
	// combined with any other filter parameter.
	BundleId *string `type:"string"`

	// Specifies the directory identifier to which to limit the WorkSpaces. Optionally,
	// you can specify a specific directory user with the UserName parameter. This
	// parameter cannot be combined with any other filter parameter.
	DirectoryId *string `type:"string"`

	// The maximum number of items to return.
	Limit *int64 `min:"1" type:"integer"`

	// The NextToken value from a previous call to this operation. Pass null if
	// this is the first call.
	NextToken *string `min:"1" type:"string"`

	// Used with the DirectoryId parameter to specify the directory user for which
	// to obtain the WorkSpace.
	UserName *string `min:"1" type:"string"`

	// An array of strings that contain the identifiers of the WorkSpaces for which
	// to retrieve information. This parameter cannot be combined with any other
	// filter parameter.
	//
	// Because the CreateWorkspaces operation is asynchronous, the identifier returned
	// by CreateWorkspaces is not immediately available. If you immediately call
	// DescribeWorkspaces with this identifier, no information will be returned.
	WorkspaceIds []*string `min:"1" type:"list"`
	// contains filtered or unexported fields
}

Contains the inputs for the DescribeWorkspaces operation.

func (DescribeWorkspacesInput) GoString added in v0.6.5

func (s DescribeWorkspacesInput) GoString() string

GoString returns the string representation

func (DescribeWorkspacesInput) String added in v0.6.5

func (s DescribeWorkspacesInput) String() string

String returns the string representation

type DescribeWorkspacesOutput

type DescribeWorkspacesOutput struct {

	// If not null, more results are available. Pass this value for the NextToken
	// parameter in a subsequent call to this operation to retrieve the next set
	// of items. This token is valid for one day and must be used within that timeframe.
	NextToken *string `min:"1" type:"string"`

	// An array of structures that contain the information about the WorkSpaces.
	//
	// Because the CreateWorkspaces operation is asynchronous, some of this information
	// may be incomplete for a newly-created WorkSpace.
	Workspaces []*Workspace `type:"list"`
	// contains filtered or unexported fields
}

Contains the results for the DescribeWorkspaces operation.

func (DescribeWorkspacesOutput) GoString added in v0.6.5

func (s DescribeWorkspacesOutput) GoString() string

GoString returns the string representation

func (DescribeWorkspacesOutput) String added in v0.6.5

func (s DescribeWorkspacesOutput) String() string

String returns the string representation

type FailedCreateWorkspaceRequest

type FailedCreateWorkspaceRequest struct {

	// The error code.
	ErrorCode *string `type:"string"`

	// The textual error message.
	ErrorMessage *string `type:"string"`

	// A WorkspaceRequest object that contains the information about the WorkSpace
	// that could not be created.
	WorkspaceRequest *WorkspaceRequest `type:"structure"`
	// contains filtered or unexported fields
}

Contains information about a WorkSpace that could not be created.

func (FailedCreateWorkspaceRequest) GoString added in v0.6.5

func (s FailedCreateWorkspaceRequest) GoString() string

GoString returns the string representation

func (FailedCreateWorkspaceRequest) String added in v0.6.5

String returns the string representation

type FailedWorkspaceChangeRequest

type FailedWorkspaceChangeRequest struct {

	// The error code.
	ErrorCode *string `type:"string"`

	// The textual error message.
	ErrorMessage *string `type:"string"`

	// The identifier of the WorkSpace.
	WorkspaceId *string `type:"string"`
	// contains filtered or unexported fields
}

Contains information about a WorkSpace that could not be rebooted (RebootWorkspaces), rebuilt (RebuildWorkspaces), or terminated (TerminateWorkspaces).

func (FailedWorkspaceChangeRequest) GoString added in v0.6.5

func (s FailedWorkspaceChangeRequest) GoString() string

GoString returns the string representation

func (FailedWorkspaceChangeRequest) String added in v0.6.5

String returns the string representation

type RebootRequest

type RebootRequest struct {

	// The identifier of the WorkSpace to reboot.
	WorkspaceId *string `type:"string" required:"true"`
	// contains filtered or unexported fields
}

Contains information used with the RebootWorkspaces operation to reboot a WorkSpace.

func (RebootRequest) GoString added in v0.6.5

func (s RebootRequest) GoString() string

GoString returns the string representation

func (RebootRequest) String added in v0.6.5

func (s RebootRequest) String() string

String returns the string representation

type RebootWorkspacesInput

type RebootWorkspacesInput struct {

	// An array of structures that specify the WorkSpaces to reboot.
	RebootWorkspaceRequests []*RebootRequest `min:"1" type:"list" required:"true"`
	// contains filtered or unexported fields
}

Contains the inputs for the RebootWorkspaces operation.

func (RebootWorkspacesInput) GoString added in v0.6.5

func (s RebootWorkspacesInput) GoString() string

GoString returns the string representation

func (RebootWorkspacesInput) String added in v0.6.5

func (s RebootWorkspacesInput) String() string

String returns the string representation

type RebootWorkspacesOutput

type RebootWorkspacesOutput struct {

	// An array of structures that represent any WorkSpaces that could not be rebooted.
	FailedRequests []*FailedWorkspaceChangeRequest `type:"list"`
	// contains filtered or unexported fields
}

Contains the results of the RebootWorkspaces operation.

func (RebootWorkspacesOutput) GoString added in v0.6.5

func (s RebootWorkspacesOutput) GoString() string

GoString returns the string representation

func (RebootWorkspacesOutput) String added in v0.6.5

func (s RebootWorkspacesOutput) String() string

String returns the string representation

type RebuildRequest

type RebuildRequest struct {

	// The identifier of the WorkSpace to rebuild.
	WorkspaceId *string `type:"string" required:"true"`
	// contains filtered or unexported fields
}

Contains information used with the RebuildWorkspaces operation to rebuild a WorkSpace.

func (RebuildRequest) GoString added in v0.6.5

func (s RebuildRequest) GoString() string

GoString returns the string representation

func (RebuildRequest) String added in v0.6.5

func (s RebuildRequest) String() string

String returns the string representation

type RebuildWorkspacesInput

type RebuildWorkspacesInput struct {

	// An array of structures that specify the WorkSpaces to rebuild.
	RebuildWorkspaceRequests []*RebuildRequest `min:"1" type:"list" required:"true"`
	// contains filtered or unexported fields
}

Contains the inputs for the RebuildWorkspaces operation.

func (RebuildWorkspacesInput) GoString added in v0.6.5

func (s RebuildWorkspacesInput) GoString() string

GoString returns the string representation

func (RebuildWorkspacesInput) String added in v0.6.5

func (s RebuildWorkspacesInput) String() string

String returns the string representation

type RebuildWorkspacesOutput

type RebuildWorkspacesOutput struct {

	// An array of structures that represent any WorkSpaces that could not be rebuilt.
	FailedRequests []*FailedWorkspaceChangeRequest `type:"list"`
	// contains filtered or unexported fields
}

Contains the results of the RebuildWorkspaces operation.

func (RebuildWorkspacesOutput) GoString added in v0.6.5

func (s RebuildWorkspacesOutput) GoString() string

GoString returns the string representation

func (RebuildWorkspacesOutput) String added in v0.6.5

func (s RebuildWorkspacesOutput) String() string

String returns the string representation

type TerminateRequest

type TerminateRequest struct {

	// The identifier of the WorkSpace to terminate.
	WorkspaceId *string `type:"string" required:"true"`
	// contains filtered or unexported fields
}

Contains information used with the TerminateWorkspaces operation to terminate a WorkSpace.

func (TerminateRequest) GoString added in v0.6.5

func (s TerminateRequest) GoString() string

GoString returns the string representation

func (TerminateRequest) String added in v0.6.5

func (s TerminateRequest) String() string

String returns the string representation

type TerminateWorkspacesInput

type TerminateWorkspacesInput struct {

	// An array of structures that specify the WorkSpaces to terminate.
	TerminateWorkspaceRequests []*TerminateRequest `min:"1" type:"list" required:"true"`
	// contains filtered or unexported fields
}

Contains the inputs for the TerminateWorkspaces operation.

func (TerminateWorkspacesInput) GoString added in v0.6.5

func (s TerminateWorkspacesInput) GoString() string

GoString returns the string representation

func (TerminateWorkspacesInput) String added in v0.6.5

func (s TerminateWorkspacesInput) String() string

String returns the string representation

type TerminateWorkspacesOutput

type TerminateWorkspacesOutput struct {

	// An array of structures that represent any WorkSpaces that could not be terminated.
	FailedRequests []*FailedWorkspaceChangeRequest `type:"list"`
	// contains filtered or unexported fields
}

Contains the results of the TerminateWorkspaces operation.

func (TerminateWorkspacesOutput) GoString added in v0.6.5

func (s TerminateWorkspacesOutput) GoString() string

GoString returns the string representation

func (TerminateWorkspacesOutput) String added in v0.6.5

func (s TerminateWorkspacesOutput) String() string

String returns the string representation

type UserStorage

type UserStorage struct {

	// The amount of user storage for the bundle.
	Capacity *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Contains information about the user storage for a WorkSpace bundle.

func (UserStorage) GoString added in v0.6.5

func (s UserStorage) GoString() string

GoString returns the string representation

func (UserStorage) String added in v0.6.5

func (s UserStorage) String() string

String returns the string representation

type WorkSpaces

type WorkSpaces struct {
	*client.Client
}

This is the Amazon WorkSpaces API Reference. This guide provides detailed information about Amazon WorkSpaces operations, data types, parameters, and errors. The service client's operations are safe to be used concurrently. It is not safe to mutate any of the client's properties though.

func New

func New(p client.ConfigProvider, cfgs ...*aws.Config) *WorkSpaces

New creates a new instance of the WorkSpaces client with a session. If additional configuration is needed for the client instance use the optional aws.Config parameter to add your extra config.

Example:

// Create a WorkSpaces client from just a session.
svc := workspaces.New(mySession)

// Create a WorkSpaces client with additional configuration
svc := workspaces.New(mySession, aws.NewConfig().WithRegion("us-west-2"))

func (*WorkSpaces) CreateWorkspaces

func (c *WorkSpaces) CreateWorkspaces(input *CreateWorkspacesInput) (*CreateWorkspacesOutput, error)

Creates one or more WorkSpaces.

This operation is asynchronous and returns before the WorkSpaces are created.
Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/workspaces"
)

func main() {
	svc := workspaces.New(session.New())

	params := &workspaces.CreateWorkspacesInput{
		Workspaces: []*workspaces.WorkspaceRequest{ // Required
			{ // Required
				BundleId:                    aws.String("BundleId"),    // Required
				DirectoryId:                 aws.String("DirectoryId"), // Required
				UserName:                    aws.String("UserName"),    // Required
				RootVolumeEncryptionEnabled: aws.Bool(true),
				UserVolumeEncryptionEnabled: aws.Bool(true),
				VolumeEncryptionKey:         aws.String("VolumeEncryptionKey"),
			},
			// More values...
		},
	}
	resp, err := svc.CreateWorkspaces(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*WorkSpaces) CreateWorkspacesRequest

func (c *WorkSpaces) CreateWorkspacesRequest(input *CreateWorkspacesInput) (req *request.Request, output *CreateWorkspacesOutput)

CreateWorkspacesRequest generates a request for the CreateWorkspaces operation.

func (*WorkSpaces) DescribeWorkspaceBundles

func (c *WorkSpaces) DescribeWorkspaceBundles(input *DescribeWorkspaceBundlesInput) (*DescribeWorkspaceBundlesOutput, error)

Obtains information about the WorkSpace bundles that are available to your account in the specified region.

You can filter the results with either the BundleIds parameter, or the Owner parameter, but not both.

This operation supports pagination with the use of the NextToken request and response parameters. If more results are available, the NextToken response member contains a token that you pass in the next call to this operation to retrieve the next set of items.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/workspaces"
)

func main() {
	svc := workspaces.New(session.New())

	params := &workspaces.DescribeWorkspaceBundlesInput{
		BundleIds: []*string{
			aws.String("BundleId"), // Required
			// More values...
		},
		NextToken: aws.String("PaginationToken"),
		Owner:     aws.String("BundleOwner"),
	}
	resp, err := svc.DescribeWorkspaceBundles(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*WorkSpaces) DescribeWorkspaceBundlesPages added in v0.6.5

func (c *WorkSpaces) DescribeWorkspaceBundlesPages(input *DescribeWorkspaceBundlesInput, fn func(p *DescribeWorkspaceBundlesOutput, lastPage bool) (shouldContinue bool)) error

func (*WorkSpaces) DescribeWorkspaceBundlesRequest

func (c *WorkSpaces) DescribeWorkspaceBundlesRequest(input *DescribeWorkspaceBundlesInput) (req *request.Request, output *DescribeWorkspaceBundlesOutput)

DescribeWorkspaceBundlesRequest generates a request for the DescribeWorkspaceBundles operation.

func (*WorkSpaces) DescribeWorkspaceDirectories

func (c *WorkSpaces) DescribeWorkspaceDirectories(input *DescribeWorkspaceDirectoriesInput) (*DescribeWorkspaceDirectoriesOutput, error)

Retrieves information about the AWS Directory Service directories in the region that are registered with Amazon WorkSpaces and are available to your account.

This operation supports pagination with the use of the NextToken request and response parameters. If more results are available, the NextToken response member contains a token that you pass in the next call to this operation to retrieve the next set of items.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/workspaces"
)

func main() {
	svc := workspaces.New(session.New())

	params := &workspaces.DescribeWorkspaceDirectoriesInput{
		DirectoryIds: []*string{
			aws.String("DirectoryId"), // Required
			// More values...
		},
		NextToken: aws.String("PaginationToken"),
	}
	resp, err := svc.DescribeWorkspaceDirectories(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*WorkSpaces) DescribeWorkspaceDirectoriesPages added in v0.6.5

func (c *WorkSpaces) DescribeWorkspaceDirectoriesPages(input *DescribeWorkspaceDirectoriesInput, fn func(p *DescribeWorkspaceDirectoriesOutput, lastPage bool) (shouldContinue bool)) error

func (*WorkSpaces) DescribeWorkspaceDirectoriesRequest

func (c *WorkSpaces) DescribeWorkspaceDirectoriesRequest(input *DescribeWorkspaceDirectoriesInput) (req *request.Request, output *DescribeWorkspaceDirectoriesOutput)

DescribeWorkspaceDirectoriesRequest generates a request for the DescribeWorkspaceDirectories operation.

func (*WorkSpaces) DescribeWorkspaces

func (c *WorkSpaces) DescribeWorkspaces(input *DescribeWorkspacesInput) (*DescribeWorkspacesOutput, error)

Obtains information about the specified WorkSpaces.

Only one of the filter parameters, such as BundleId, DirectoryId, or WorkspaceIds, can be specified at a time.

This operation supports pagination with the use of the NextToken request and response parameters. If more results are available, the NextToken response member contains a token that you pass in the next call to this operation to retrieve the next set of items.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/workspaces"
)

func main() {
	svc := workspaces.New(session.New())

	params := &workspaces.DescribeWorkspacesInput{
		BundleId:    aws.String("BundleId"),
		DirectoryId: aws.String("DirectoryId"),
		Limit:       aws.Int64(1),
		NextToken:   aws.String("PaginationToken"),
		UserName:    aws.String("UserName"),
		WorkspaceIds: []*string{
			aws.String("WorkspaceId"), // Required
			// More values...
		},
	}
	resp, err := svc.DescribeWorkspaces(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*WorkSpaces) DescribeWorkspacesPages added in v0.6.5

func (c *WorkSpaces) DescribeWorkspacesPages(input *DescribeWorkspacesInput, fn func(p *DescribeWorkspacesOutput, lastPage bool) (shouldContinue bool)) error

func (*WorkSpaces) DescribeWorkspacesRequest

func (c *WorkSpaces) DescribeWorkspacesRequest(input *DescribeWorkspacesInput) (req *request.Request, output *DescribeWorkspacesOutput)

DescribeWorkspacesRequest generates a request for the DescribeWorkspaces operation.

func (*WorkSpaces) RebootWorkspaces

func (c *WorkSpaces) RebootWorkspaces(input *RebootWorkspacesInput) (*RebootWorkspacesOutput, error)

Reboots the specified WorkSpaces.

To be able to reboot a WorkSpace, the WorkSpace must have a State of AVAILABLE, IMPAIRED, or INOPERABLE.

This operation is asynchronous and will return before the WorkSpaces have

rebooted.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/workspaces"
)

func main() {
	svc := workspaces.New(session.New())

	params := &workspaces.RebootWorkspacesInput{
		RebootWorkspaceRequests: []*workspaces.RebootRequest{ // Required
			{ // Required
				WorkspaceId: aws.String("WorkspaceId"), // Required
			},
			// More values...
		},
	}
	resp, err := svc.RebootWorkspaces(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*WorkSpaces) RebootWorkspacesRequest

func (c *WorkSpaces) RebootWorkspacesRequest(input *RebootWorkspacesInput) (req *request.Request, output *RebootWorkspacesOutput)

RebootWorkspacesRequest generates a request for the RebootWorkspaces operation.

func (*WorkSpaces) RebuildWorkspaces

func (c *WorkSpaces) RebuildWorkspaces(input *RebuildWorkspacesInput) (*RebuildWorkspacesOutput, error)

Rebuilds the specified WorkSpaces.

Rebuilding a WorkSpace is a potentially destructive action that can result in the loss of data. Rebuilding a WorkSpace causes the following to occur:

The system is restored to the image of the bundle that the WorkSpace is

created from. Any applications that have been installed, or system settings that have been made since the WorkSpace was created will be lost. The data drive (D drive) is re-created from the last automatic snapshot taken of the data drive. The current contents of the data drive are overwritten. Automatic snapshots of the data drive are taken every 12 hours, so the snapshot can be as much as 12 hours old. To be able to rebuild a WorkSpace, the WorkSpace must have a State of AVAILABLE or ERROR.

This operation is asynchronous and will return before the WorkSpaces have

been completely rebuilt.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/workspaces"
)

func main() {
	svc := workspaces.New(session.New())

	params := &workspaces.RebuildWorkspacesInput{
		RebuildWorkspaceRequests: []*workspaces.RebuildRequest{ // Required
			{ // Required
				WorkspaceId: aws.String("WorkspaceId"), // Required
			},
			// More values...
		},
	}
	resp, err := svc.RebuildWorkspaces(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*WorkSpaces) RebuildWorkspacesRequest

func (c *WorkSpaces) RebuildWorkspacesRequest(input *RebuildWorkspacesInput) (req *request.Request, output *RebuildWorkspacesOutput)

RebuildWorkspacesRequest generates a request for the RebuildWorkspaces operation.

func (*WorkSpaces) TerminateWorkspaces

func (c *WorkSpaces) TerminateWorkspaces(input *TerminateWorkspacesInput) (*TerminateWorkspacesOutput, error)

Terminates the specified WorkSpaces.

Terminating a WorkSpace is a permanent action and cannot be undone. The user's data is not maintained and will be destroyed. If you need to archive any user data, contact Amazon Web Services before terminating the WorkSpace.

You can terminate a WorkSpace that is in any state except SUSPENDED.

This operation is asynchronous and will return before the WorkSpaces have

been completely terminated.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/workspaces"
)

func main() {
	svc := workspaces.New(session.New())

	params := &workspaces.TerminateWorkspacesInput{
		TerminateWorkspaceRequests: []*workspaces.TerminateRequest{ // Required
			{ // Required
				WorkspaceId: aws.String("WorkspaceId"), // Required
			},
			// More values...
		},
	}
	resp, err := svc.TerminateWorkspaces(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*WorkSpaces) TerminateWorkspacesRequest

func (c *WorkSpaces) TerminateWorkspacesRequest(input *TerminateWorkspacesInput) (req *request.Request, output *TerminateWorkspacesOutput)

TerminateWorkspacesRequest generates a request for the TerminateWorkspaces operation.

type Workspace

type Workspace struct {

	// The identifier of the bundle that the WorkSpace was created from.
	BundleId *string `type:"string"`

	// The name of the WorkSpace as seen by the operating system.
	ComputerName *string `type:"string"`

	// The identifier of the AWS Directory Service directory that the WorkSpace
	// belongs to.
	DirectoryId *string `type:"string"`

	// If the WorkSpace could not be created, this contains the error code.
	ErrorCode *string `type:"string"`

	// If the WorkSpace could not be created, this contains a textual error message
	// that describes the failure.
	ErrorMessage *string `type:"string"`

	// The IP address of the WorkSpace.
	IpAddress *string `type:"string"`

	// Specifies whether the data stored on the root volume, or C: drive, is encrypted.
	RootVolumeEncryptionEnabled *bool `type:"boolean"`

	// The operational state of the WorkSpace.
	State *string `type:"string" enum:"WorkspaceState"`

	// The identifier of the subnet that the WorkSpace is in.
	SubnetId *string `type:"string"`

	// The user that the WorkSpace is assigned to.
	UserName *string `min:"1" type:"string"`

	// Specifies whether the data stored on the user volume, or D: drive, is encrypted.
	UserVolumeEncryptionEnabled *bool `type:"boolean"`

	// The KMS key used to encrypt data stored on your WorkSpace.
	VolumeEncryptionKey *string `type:"string"`

	// The identifier of the WorkSpace.
	WorkspaceId *string `type:"string"`
	// contains filtered or unexported fields
}

Contains information about a WorkSpace.

func (Workspace) GoString added in v0.6.5

func (s Workspace) GoString() string

GoString returns the string representation

func (Workspace) String added in v0.6.5

func (s Workspace) String() string

String returns the string representation

type WorkspaceBundle

type WorkspaceBundle struct {

	// The bundle identifier.
	BundleId *string `type:"string"`

	// A ComputeType object that specifies the compute type for the bundle.
	ComputeType *ComputeType `type:"structure"`

	// The bundle description.
	Description *string `type:"string"`

	// The name of the bundle.
	Name *string `min:"1" type:"string"`

	// The owner of the bundle. This contains the owner's account identifier, or
	// AMAZON if the bundle is provided by AWS.
	Owner *string `type:"string"`

	// A UserStorage object that specifies the amount of user storage that the bundle
	// contains.
	UserStorage *UserStorage `type:"structure"`
	// contains filtered or unexported fields
}

Contains information about a WorkSpace bundle.

func (WorkspaceBundle) GoString added in v0.6.5

func (s WorkspaceBundle) GoString() string

GoString returns the string representation

func (WorkspaceBundle) String added in v0.6.5

func (s WorkspaceBundle) String() string

String returns the string representation

type WorkspaceDirectory

type WorkspaceDirectory struct {

	// The directory alias.
	Alias *string `type:"string"`

	// The user name for the service account.
	CustomerUserName *string `min:"1" type:"string"`

	// The directory identifier.
	DirectoryId *string `type:"string"`

	// The name of the directory.
	DirectoryName *string `type:"string"`

	// The directory type.
	DirectoryType *string `type:"string" enum:"WorkspaceDirectoryType"`

	// An array of strings that contains the IP addresses of the DNS servers for
	// the directory.
	DnsIpAddresses []*string `type:"list"`

	// The identifier of the IAM role. This is the role that allows Amazon WorkSpaces
	// to make calls to other services, such as Amazon EC2, on your behalf.
	IamRoleId *string `type:"string"`

	// The registration code for the directory. This is the code that users enter
	// in their Amazon WorkSpaces client application to connect to the directory.
	RegistrationCode *string `min:"1" type:"string"`

	// The state of the directory's registration with Amazon WorkSpaces
	State *string `type:"string" enum:"WorkspaceDirectoryState"`

	// An array of strings that contains the identifiers of the subnets used with
	// the directory.
	SubnetIds []*string `type:"list"`

	// A structure that specifies the default creation properties for all WorkSpaces
	// in the directory.
	WorkspaceCreationProperties *DefaultWorkspaceCreationProperties `type:"structure"`

	// The identifier of the security group that is assigned to new WorkSpaces.
	WorkspaceSecurityGroupId *string `type:"string"`
	// contains filtered or unexported fields
}

Contains information about an AWS Directory Service directory for use with Amazon WorkSpaces.

func (WorkspaceDirectory) GoString added in v0.6.5

func (s WorkspaceDirectory) GoString() string

GoString returns the string representation

func (WorkspaceDirectory) String added in v0.6.5

func (s WorkspaceDirectory) String() string

String returns the string representation

type WorkspaceRequest

type WorkspaceRequest struct {

	// The identifier of the bundle to create the WorkSpace from. You can use the
	// DescribeWorkspaceBundles operation to obtain a list of the bundles that are
	// available.
	BundleId *string `type:"string" required:"true"`

	// The identifier of the AWS Directory Service directory to create the WorkSpace
	// in. You can use the DescribeWorkspaceDirectories operation to obtain a list
	// of the directories that are available.
	DirectoryId *string `type:"string" required:"true"`

	// Specifies whether the data stored on the root volume, or C: drive, is encrypted.
	RootVolumeEncryptionEnabled *bool `type:"boolean"`

	// The username that the WorkSpace is assigned to. This username must exist
	// in the AWS Directory Service directory specified by the DirectoryId member.
	UserName *string `min:"1" type:"string" required:"true"`

	// Specifies whether the data stored on the user volume, or D: drive, is encrypted.
	UserVolumeEncryptionEnabled *bool `type:"boolean"`

	// The KMS key used to encrypt data stored on your WorkSpace.
	VolumeEncryptionKey *string `type:"string"`
	// contains filtered or unexported fields
}

Contains information about a WorkSpace creation request.

func (WorkspaceRequest) GoString added in v0.6.5

func (s WorkspaceRequest) GoString() string

GoString returns the string representation

func (WorkspaceRequest) String added in v0.6.5

func (s WorkspaceRequest) String() string

String returns the string representation

Directories

Path Synopsis
Package workspacesiface provides an interface for the Amazon WorkSpaces.
Package workspacesiface provides an interface for the Amazon WorkSpaces.

Jump to

Keyboard shortcuts

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