UpdateWorkspacesPool - Amazon WorkSpaces Service

UpdateWorkspacesPool

Updates the specified pool.

Request Syntax

{ "ApplicationSettings": { "SettingsGroup": "string", "Status": "string" }, "BundleId": "string", "Capacity": { "DesiredUserSessions": number }, "Description": "string", "DirectoryId": "string", "PoolId": "string", "TimeoutSettings": { "DisconnectTimeoutInSeconds": number, "IdleDisconnectTimeoutInSeconds": number, "MaxUserDurationInSeconds": number } }

Request Parameters

The request accepts the following data in JSON format.

ApplicationSettings

The persistent application settings for users in the pool.

Type: ApplicationSettingsRequest object

Required: No

BundleId

The identifier of the bundle.

Type: String

Pattern: ^wsb-[0-9a-z]{8,63}$

Required: No

Capacity

The desired capacity for the pool.

Type: Capacity object

Required: No

Description

Describes the specified pool to update.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Pattern: ^[a-zA-Z0-9_./() -]+$

Required: No

DirectoryId

The identifier of the directory.

Type: String

Length Constraints: Minimum length of 10. Maximum length of 65.

Pattern: ^(d-[0-9a-f]{8,63}$)|(wsd-[0-9a-z]{8,63}$)

Required: No

PoolId

The identifier of the specified pool to update.

Type: String

Pattern: ^wspool-[0-9a-z]{9}$

Required: Yes

TimeoutSettings

Indicates the timeout settings of the specified pool.

Type: TimeoutSettings object

Required: No

Response Syntax

{ "WorkspacesPool": { "ApplicationSettings": { "S3BucketName": "string", "SettingsGroup": "string", "Status": "string" }, "BundleId": "string", "CapacityStatus": { "ActiveUserSessions": number, "ActualUserSessions": number, "AvailableUserSessions": number, "DesiredUserSessions": number }, "CreatedAt": number, "Description": "string", "DirectoryId": "string", "Errors": [ { "ErrorCode": "string", "ErrorMessage": "string" } ], "PoolArn": "string", "PoolId": "string", "PoolName": "string", "State": "string", "TimeoutSettings": { "DisconnectTimeoutInSeconds": number, "IdleDisconnectTimeoutInSeconds": number, "MaxUserDurationInSeconds": number } } }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

WorkspacesPool

Describes the specified pool.

Type: WorkspacesPool object

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

The user is not authorized to access a resource.

HTTP Status Code: 400

InvalidParameterValuesException

One or more parameter values are not valid.

HTTP Status Code: 400

InvalidResourceStateException

The state of the resource is not valid for this operation.

HTTP Status Code: 400

OperationInProgressException

The properties of this WorkSpace are currently being modified. Try again in a moment.

HTTP Status Code: 400

OperationNotSupportedException

This operation is not supported.

HTTP Status Code: 400

ResourceLimitExceededException

Your resource limits have been exceeded.

HTTP Status Code: 400

ResourceNotFoundException

The resource could not be found.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: