Documentation
¶
Overview ¶
Package workspaces provides a client for Amazon WorkSpaces.
Index ¶
- Constants
- type ComputeType
- type CreateTagsInput
- type CreateTagsOutput
- type CreateWorkspacesInput
- type CreateWorkspacesOutput
- type DefaultWorkspaceCreationProperties
- type DeleteTagsInput
- type DeleteTagsOutput
- type DescribeTagsInput
- type DescribeTagsOutput
- type DescribeWorkspaceBundlesInput
- type DescribeWorkspaceBundlesOutput
- type DescribeWorkspaceDirectoriesInput
- type DescribeWorkspaceDirectoriesOutput
- type DescribeWorkspacesInput
- type DescribeWorkspacesOutput
- type FailedCreateWorkspaceRequest
- type FailedWorkspaceChangeRequest
- type RebootRequest
- type RebootWorkspacesInput
- type RebootWorkspacesOutput
- type RebuildRequest
- type RebuildWorkspacesInput
- type RebuildWorkspacesOutput
- type Tag
- type TerminateRequest
- type TerminateWorkspacesInput
- type TerminateWorkspacesOutput
- type UserStorage
- type WorkSpaces
- func (c *WorkSpaces) CreateTags(input *CreateTagsInput) (*CreateTagsOutput, error)
- func (c *WorkSpaces) CreateTagsRequest(input *CreateTagsInput) (req *request.Request, output *CreateTagsOutput)
- func (c *WorkSpaces) CreateWorkspaces(input *CreateWorkspacesInput) (*CreateWorkspacesOutput, error)
- func (c *WorkSpaces) CreateWorkspacesRequest(input *CreateWorkspacesInput) (req *request.Request, output *CreateWorkspacesOutput)
- func (c *WorkSpaces) DeleteTags(input *DeleteTagsInput) (*DeleteTagsOutput, error)
- func (c *WorkSpaces) DeleteTagsRequest(input *DeleteTagsInput) (req *request.Request, output *DeleteTagsOutput)
- func (c *WorkSpaces) DescribeTags(input *DescribeTagsInput) (*DescribeTagsOutput, error)
- func (c *WorkSpaces) DescribeTagsRequest(input *DescribeTagsInput) (req *request.Request, output *DescribeTagsOutput)
- func (c *WorkSpaces) DescribeWorkspaceBundles(input *DescribeWorkspaceBundlesInput) (*DescribeWorkspaceBundlesOutput, error)
- func (c *WorkSpaces) DescribeWorkspaceBundlesPages(input *DescribeWorkspaceBundlesInput, ...) error
- func (c *WorkSpaces) DescribeWorkspaceBundlesRequest(input *DescribeWorkspaceBundlesInput) (req *request.Request, output *DescribeWorkspaceBundlesOutput)
- func (c *WorkSpaces) DescribeWorkspaceDirectories(input *DescribeWorkspaceDirectoriesInput) (*DescribeWorkspaceDirectoriesOutput, error)
- func (c *WorkSpaces) DescribeWorkspaceDirectoriesPages(input *DescribeWorkspaceDirectoriesInput, ...) error
- func (c *WorkSpaces) DescribeWorkspaceDirectoriesRequest(input *DescribeWorkspaceDirectoriesInput) (req *request.Request, output *DescribeWorkspaceDirectoriesOutput)
- func (c *WorkSpaces) DescribeWorkspaces(input *DescribeWorkspacesInput) (*DescribeWorkspacesOutput, error)
- func (c *WorkSpaces) DescribeWorkspacesPages(input *DescribeWorkspacesInput, ...) error
- func (c *WorkSpaces) DescribeWorkspacesRequest(input *DescribeWorkspacesInput) (req *request.Request, output *DescribeWorkspacesOutput)
- func (c *WorkSpaces) RebootWorkspaces(input *RebootWorkspacesInput) (*RebootWorkspacesOutput, error)
- func (c *WorkSpaces) RebootWorkspacesRequest(input *RebootWorkspacesInput) (req *request.Request, output *RebootWorkspacesOutput)
- func (c *WorkSpaces) RebuildWorkspaces(input *RebuildWorkspacesInput) (*RebuildWorkspacesOutput, error)
- func (c *WorkSpaces) RebuildWorkspacesRequest(input *RebuildWorkspacesInput) (req *request.Request, output *RebuildWorkspacesOutput)
- func (c *WorkSpaces) TerminateWorkspaces(input *TerminateWorkspacesInput) (*TerminateWorkspacesOutput, error)
- func (c *WorkSpaces) TerminateWorkspacesRequest(input *TerminateWorkspacesInput) (req *request.Request, output *TerminateWorkspacesOutput)
- type Workspace
- type WorkspaceBundle
- type WorkspaceDirectory
- type WorkspaceRequest
Examples ¶
Constants ¶
const ( // @enum Compute ComputeValue = "VALUE" // @enum Compute ComputeStandard = "STANDARD" // @enum Compute ComputePerformance = "PERFORMANCE" )
const ( // @enum WorkspaceDirectoryState WorkspaceDirectoryStateRegistering = "REGISTERING" // @enum WorkspaceDirectoryState WorkspaceDirectoryStateRegistered = "REGISTERED" // @enum WorkspaceDirectoryState WorkspaceDirectoryStateDeregistering = "DEREGISTERING" // @enum WorkspaceDirectoryState WorkspaceDirectoryStateDeregistered = "DEREGISTERED" // @enum WorkspaceDirectoryState WorkspaceDirectoryStateError = "ERROR" )
const ( // @enum WorkspaceDirectoryType WorkspaceDirectoryTypeSimpleAd = "SIMPLE_AD" // @enum WorkspaceDirectoryType WorkspaceDirectoryTypeAdConnector = "AD_CONNECTOR" )
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" )
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 ¶
func (s ComputeType) GoString() string
GoString returns the string representation
func (ComputeType) String ¶
func (s ComputeType) String() string
String returns the string representation
type CreateTagsInput ¶
type CreateTagsInput struct { // The resource ID of the request. ResourceId *string `min:"1" type:"string" required:"true"` // The tags of the request. Tags []*Tag `type:"list" required:"true"` // contains filtered or unexported fields }
The request of the create tags action.
func (CreateTagsInput) GoString ¶
func (s CreateTagsInput) GoString() string
GoString returns the string representation
func (CreateTagsInput) String ¶
func (s CreateTagsInput) String() string
String returns the string representation
func (*CreateTagsInput) Validate ¶
func (s *CreateTagsInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateTagsOutput ¶
type CreateTagsOutput struct {
// contains filtered or unexported fields
}
The result of the create tags action.
func (CreateTagsOutput) GoString ¶
func (s CreateTagsOutput) GoString() string
GoString returns the string representation
func (CreateTagsOutput) String ¶
func (s CreateTagsOutput) 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 ¶
func (s CreateWorkspacesInput) GoString() string
GoString returns the string representation
func (CreateWorkspacesInput) String ¶
func (s CreateWorkspacesInput) String() string
String returns the string representation
func (*CreateWorkspacesInput) Validate ¶
func (s *CreateWorkspacesInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
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 ¶
func (s CreateWorkspacesOutput) GoString() string
GoString returns the string representation
func (CreateWorkspacesOutput) String ¶
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 ¶
func (s DefaultWorkspaceCreationProperties) GoString() string
GoString returns the string representation
func (DefaultWorkspaceCreationProperties) String ¶
func (s DefaultWorkspaceCreationProperties) String() string
String returns the string representation
type DeleteTagsInput ¶
type DeleteTagsInput struct { // The resource ID of the request. ResourceId *string `min:"1" type:"string" required:"true"` // The tag keys of the request. TagKeys []*string `type:"list" required:"true"` // contains filtered or unexported fields }
The request of the delete tags action.
func (DeleteTagsInput) GoString ¶
func (s DeleteTagsInput) GoString() string
GoString returns the string representation
func (DeleteTagsInput) String ¶
func (s DeleteTagsInput) String() string
String returns the string representation
func (*DeleteTagsInput) Validate ¶
func (s *DeleteTagsInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteTagsOutput ¶
type DeleteTagsOutput struct {
// contains filtered or unexported fields
}
The result of the delete tags action.
func (DeleteTagsOutput) GoString ¶
func (s DeleteTagsOutput) GoString() string
GoString returns the string representation
func (DeleteTagsOutput) String ¶
func (s DeleteTagsOutput) String() string
String returns the string representation
type DescribeTagsInput ¶
type DescribeTagsInput struct { // The resource ID of the request. ResourceId *string `min:"1" type:"string" required:"true"` // contains filtered or unexported fields }
The request of the describe tags action.
func (DescribeTagsInput) GoString ¶
func (s DescribeTagsInput) GoString() string
GoString returns the string representation
func (DescribeTagsInput) String ¶
func (s DescribeTagsInput) String() string
String returns the string representation
func (*DescribeTagsInput) Validate ¶
func (s *DescribeTagsInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DescribeTagsOutput ¶
type DescribeTagsOutput struct { // The list of tags. TagList []*Tag `type:"list"` // contains filtered or unexported fields }
The result of the describe tags action.
func (DescribeTagsOutput) GoString ¶
func (s DescribeTagsOutput) GoString() string
GoString returns the string representation
func (DescribeTagsOutput) String ¶
func (s DescribeTagsOutput) String() string
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 ¶
func (s DescribeWorkspaceBundlesInput) GoString() string
GoString returns the string representation
func (DescribeWorkspaceBundlesInput) String ¶
func (s DescribeWorkspaceBundlesInput) String() string
String returns the string representation
func (*DescribeWorkspaceBundlesInput) Validate ¶
func (s *DescribeWorkspaceBundlesInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
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 ¶
func (s DescribeWorkspaceBundlesOutput) GoString() string
GoString returns the string representation
func (DescribeWorkspaceBundlesOutput) String ¶
func (s DescribeWorkspaceBundlesOutput) String() string
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 ¶
func (s DescribeWorkspaceDirectoriesInput) GoString() string
GoString returns the string representation
func (DescribeWorkspaceDirectoriesInput) String ¶
func (s DescribeWorkspaceDirectoriesInput) String() string
String returns the string representation
func (*DescribeWorkspaceDirectoriesInput) Validate ¶
func (s *DescribeWorkspaceDirectoriesInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
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 ¶
func (s DescribeWorkspaceDirectoriesOutput) GoString() string
GoString returns the string representation
func (DescribeWorkspaceDirectoriesOutput) String ¶
func (s DescribeWorkspaceDirectoriesOutput) String() string
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 ¶
func (s DescribeWorkspacesInput) GoString() string
GoString returns the string representation
func (DescribeWorkspacesInput) String ¶
func (s DescribeWorkspacesInput) String() string
String returns the string representation
func (*DescribeWorkspacesInput) Validate ¶
func (s *DescribeWorkspacesInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
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 ¶
func (s DescribeWorkspacesOutput) GoString() string
GoString returns the string representation
func (DescribeWorkspacesOutput) String ¶
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 ¶
func (s FailedCreateWorkspaceRequest) GoString() string
GoString returns the string representation
func (FailedCreateWorkspaceRequest) String ¶
func (s FailedCreateWorkspaceRequest) String() string
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 ¶
func (s FailedWorkspaceChangeRequest) GoString() string
GoString returns the string representation
func (FailedWorkspaceChangeRequest) String ¶
func (s FailedWorkspaceChangeRequest) String() string
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 ¶
func (s RebootRequest) GoString() string
GoString returns the string representation
func (RebootRequest) String ¶
func (s RebootRequest) String() string
String returns the string representation
func (*RebootRequest) Validate ¶
func (s *RebootRequest) Validate() error
Validate inspects the fields of the type to determine if they are valid.
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 ¶
func (s RebootWorkspacesInput) GoString() string
GoString returns the string representation
func (RebootWorkspacesInput) String ¶
func (s RebootWorkspacesInput) String() string
String returns the string representation
func (*RebootWorkspacesInput) Validate ¶
func (s *RebootWorkspacesInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
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 ¶
func (s RebootWorkspacesOutput) GoString() string
GoString returns the string representation
func (RebootWorkspacesOutput) String ¶
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 ¶
func (s RebuildRequest) GoString() string
GoString returns the string representation
func (RebuildRequest) String ¶
func (s RebuildRequest) String() string
String returns the string representation
func (*RebuildRequest) Validate ¶
func (s *RebuildRequest) Validate() error
Validate inspects the fields of the type to determine if they are valid.
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 ¶
func (s RebuildWorkspacesInput) GoString() string
GoString returns the string representation
func (RebuildWorkspacesInput) String ¶
func (s RebuildWorkspacesInput) String() string
String returns the string representation
func (*RebuildWorkspacesInput) Validate ¶
func (s *RebuildWorkspacesInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
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 ¶
func (s RebuildWorkspacesOutput) GoString() string
GoString returns the string representation
func (RebuildWorkspacesOutput) String ¶
func (s RebuildWorkspacesOutput) String() string
String returns the string representation
type Tag ¶
type Tag struct { // The key of the tag. Key *string `min:"1" type:"string" required:"true"` // The value of the tag. Value *string `type:"string"` // contains filtered or unexported fields }
Describes the tag of the WorkSpace.
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 ¶
func (s TerminateRequest) GoString() string
GoString returns the string representation
func (TerminateRequest) String ¶
func (s TerminateRequest) String() string
String returns the string representation
func (*TerminateRequest) Validate ¶
func (s *TerminateRequest) Validate() error
Validate inspects the fields of the type to determine if they are valid.
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 ¶
func (s TerminateWorkspacesInput) GoString() string
GoString returns the string representation
func (TerminateWorkspacesInput) String ¶
func (s TerminateWorkspacesInput) String() string
String returns the string representation
func (*TerminateWorkspacesInput) Validate ¶
func (s *TerminateWorkspacesInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
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 ¶
func (s TerminateWorkspacesOutput) GoString() string
GoString returns the string representation
func (TerminateWorkspacesOutput) String ¶
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 ¶
func (s UserStorage) GoString() string
GoString returns the string representation
func (UserStorage) String ¶
func (s UserStorage) String() string
String returns the string representation
type WorkSpaces ¶
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) CreateTags ¶
func (c *WorkSpaces) CreateTags(input *CreateTagsInput) (*CreateTagsOutput, error)
Creates tags for a WorkSpace.
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.CreateTagsInput{ ResourceId: aws.String("NonEmptyString"), // Required Tags: []*workspaces.Tag{ // Required { // Required Key: aws.String("TagKey"), // Required Value: aws.String("TagValue"), }, // More values... }, } resp, err := svc.CreateTags(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) CreateTagsRequest ¶
func (c *WorkSpaces) CreateTagsRequest(input *CreateTagsInput) (req *request.Request, output *CreateTagsOutput)
CreateTagsRequest generates a request for the CreateTags operation.
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), Tags: []*workspaces.Tag{ { // Required Key: aws.String("TagKey"), // Required Value: aws.String("TagValue"), }, // More values... }, 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) DeleteTags ¶
func (c *WorkSpaces) DeleteTags(input *DeleteTagsInput) (*DeleteTagsOutput, error)
Deletes tags from a WorkSpace.
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.DeleteTagsInput{ ResourceId: aws.String("NonEmptyString"), // Required TagKeys: []*string{ // Required aws.String("NonEmptyString"), // Required // More values... }, } resp, err := svc.DeleteTags(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) DeleteTagsRequest ¶
func (c *WorkSpaces) DeleteTagsRequest(input *DeleteTagsInput) (req *request.Request, output *DeleteTagsOutput)
DeleteTagsRequest generates a request for the DeleteTags operation.
func (*WorkSpaces) DescribeTags ¶
func (c *WorkSpaces) DescribeTags(input *DescribeTagsInput) (*DescribeTagsOutput, error)
Describes tags for a WorkSpace.
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.DescribeTagsInput{ ResourceId: aws.String("NonEmptyString"), // Required } resp, err := svc.DescribeTags(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) DescribeTagsRequest ¶
func (c *WorkSpaces) DescribeTagsRequest(input *DescribeTagsInput) (req *request.Request, output *DescribeTagsOutput)
DescribeTagsRequest generates a request for the DescribeTags 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 ¶
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 ¶
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 ¶
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.
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 ¶
func (s WorkspaceBundle) GoString() string
GoString returns the string representation
func (WorkspaceBundle) String ¶
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 ¶
func (s WorkspaceDirectory) GoString() string
GoString returns the string representation
func (WorkspaceDirectory) String ¶
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 tags of the WorkSpace request. Tags []*Tag `type:"list"` // 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 ¶
func (s WorkspaceRequest) GoString() string
GoString returns the string representation
func (WorkspaceRequest) String ¶
func (s WorkspaceRequest) String() string
String returns the string representation
func (*WorkspaceRequest) Validate ¶
func (s *WorkspaceRequest) Validate() error
Validate inspects the fields of the type to determine if they are valid.
Directories
¶
Path | Synopsis |
---|---|
Package workspacesiface provides an interface for the Amazon WorkSpaces.
|
Package workspacesiface provides an interface for the Amazon WorkSpaces. |