View a markdown version of this page

Actions, resources, and condition keys for AWS WorkSpaces Managed Instances - Service Authorization Reference

Actions, resources, and condition keys for AWS WorkSpaces Managed Instances

AWS WorkSpaces Managed Instances (service prefix: workspaces-instances) provides the following service-specific operations, resources, actions, and condition keys for use in IAM permission policies.

References:

API operations defined by AWS WorkSpaces Managed Instances

The following table maps API operations to the IAM actions they authorize. Only condition keys that have static values for the given API and action are listed; for the full set of condition keys supported by each action, see the Actions table.

Operation IAM action Condition key Possible value(s) Access level

AssociateVolume

workspaces-instances:AssociateVolume

Write

CreateVolume

workspaces-instances:CreateVolume

Write

CreateWorkspaceInstance

workspaces-instances:CreateWorkspaceInstance

Write

workspaces-instances:TagResource

Tagging, Write

DeleteVolume

workspaces-instances:DeleteVolume

Write

DeleteWorkspaceInstance

workspaces-instances:DeleteWorkspaceInstance

Write

DisassociateVolume

workspaces-instances:DisassociateVolume

Write

GetWorkspaceInstance

workspaces-instances:GetWorkspaceInstance

Read

ListInstanceTypes

workspaces-instances:ListInstanceTypes

List

ListRegions

workspaces-instances:ListRegions

List

ListTagsForResource

workspaces-instances:ListTagsForResource

List

ListWorkspaceInstances

workspaces-instances:ListWorkspaceInstances

List

TagResource

workspaces-instances:TagResource

Tagging, Write

UntagResource

workspaces-instances:UntagResource

Tagging, Write

Actions defined by AWS WorkSpaces Managed Instances

You can specify the following actions in the Action element of an IAM policy statement. Use policies to grant permissions to perform an operation in AWS. When you use an action in a policy, you usually allow or deny access to the API operation or CLI command with the same name. However, in some cases, a single action controls access to more than one operation. Alternatively, some operations require several different actions.

Actions Description Resource types (*required) Condition keys Access level

AssociateVolume

Grants permission to associate a workspace managed volume to a workspace managed instance in your account

WorkspaceInstanceId*

aws:ResourceTag/${TagKey}

Write

CreateVolume

Grants permission to create a workspace managed volume in your account

Write

CreateWorkspaceInstance

Grants permission to create a workspace managed instance in your account

aws:RequestTag/${TagKey}

aws:TagKeys

Write

DeleteVolume

Grants permission to delete a workspace managed volume in your account

VolumeId*

aws:ResourceTag/${TagKey}

Write

DeleteWorkspaceInstance

Grants permission to delete a workspace managed instance in your account

WorkspaceInstanceId*

aws:ResourceTag/${TagKey}

Write

DisassociateVolume

Grants permission to disassociate a workspace managed volume from a workspace managed instance in your account

WorkspaceInstanceId*

aws:ResourceTag/${TagKey}

Write

GetWorkspaceInstance

Grants permission to get details for a specific workspace managed instance in your account

WorkspaceInstanceId*

aws:ResourceTag/${TagKey}

Read

ListInstanceTypes

Grants permission to list all supported instance types

List

ListRegions

Grants permission to list all supported AWS regions

List

ListTagsForResource

Grants permission to list user tags for resources in your account

WorkspaceInstanceId*

aws:ResourceTag/${TagKey}

List

ListWorkspaceInstances

Grants permission to list workspace managed instances in your account

List

TagResource

Grants permission to add user tags to resources in your account

WorkspaceInstanceId*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

Tagging, Write

UntagResource

Grants permission to remove user tags from resources in your account

WorkspaceInstanceId*

aws:ResourceTag/${TagKey}

aws:TagKeys

Tagging, Write

Resource types defined by AWS WorkSpaces Managed Instances

The following resource types are defined by this service and can be used in the Resource element of IAM permission policy statements.

Resource types ARN Condition keys

VolumeId

arn:${Partition}:ec2:${Region}:${Account}:volume/${VolumeId}

aws:ResourceTag/${TagKey}

WorkspaceInstanceId

arn:${Partition}:workspaces-instances:${Region}:${Account}:workspaceinstance/${WorkspaceInstanceId}

aws:ResourceTag/${TagKey}

Condition keys for AWS WorkSpaces Managed Instances

AWS WorkSpaces Managed Instances defines the following condition keys that can be used in the Condition element of an IAM policy.

Condition keys Description Type

aws:RequestTag/${TagKey}

Filters access based on the tags that are passed in the request

String

aws:ResourceTag/${TagKey}

Filters access based on the tags associated with the resource

String

aws:TagKeys

Filters access based on the tag keys that are passed in the request

ArrayOfString