Amazon WorkSpaces 的操作、资源和条件键 - 服务授权参考
操作资源类型条件键
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Amazon WorkSpaces 的操作、资源和条件键

Amazon WorkSpaces（服务前缀：workspaces）提供以下服务特定的资源、操作和条件上下文键以在 IAM 权限策略中使用。

参考：

Amazon WorkSpaces 定义的操作

您可以在 IAM policy 语句的 Action 元素中指定以下操作。可以使用策略授予在 Amazon 中执行操作的权限。您在策略中使用一项操作时，通常使用相同的名称允许或拒绝对 API 操作或 CLI 命令的访问。但在某些情况下，单一动作可控制对多项操作的访问。还有某些操作需要多种不同的动作。

操作表的资源类型列指示每项操作是否支持资源级权限。如果该列没有任何值，您必须在策略语句的 Resource 元素中指定策略应用的所有资源（“*”）。通过在 IAM policy 中使用条件来筛选访问权限，以控制是否可以在资源或请求中使用特定标签键。如果操作具有一个或多个必需资源，则调用方必须具有使用这些资源来使用该操作的权限。必需资源在表中以星号 (*) 表示。如果您在 IAM policy 中使用 Resource 元素限制资源访问权限，则必须为每种必需的资源类型添加 ARN 或模式。某些操作支持多种资源类型。如果资源类型是可选的（未指示为必需），则可以选择使用一种可选资源类型。

操作表的条件键列包括可以在策略语句的 Condition 元素中指定的键。有关与服务资源关联的条件键的更多信息，请参阅资源类型表的条件键列。

注意

资源条件键在资源类型表中列出。您可以在操作表的资源类型（* 为必需）列中找到应用于某项操作的资源类型的链接。资源类型表中的资源类型包括条件密钥列，这是应用于操作表中操作的资源条件键。

有关下表中各列的详细信息，请参阅操作表。

操作 描述 访问级别 资源类型（* 为必需） 条件键 相关操作
AssociateConnectionAlias 授予将连接别名与目录关联的权限 Write

connectionalias*

directoryid*

AssociateIpGroups 授予将 IP 访问控制组与目录关联的权限 Write

directoryid*

workspaceipgroup*

AssociateWorkspaceApplication 授予将工作空间应用程序与 WorkSpace 关联的权限 Write

workspaceapplication*

workspaceid*

aws:ResourceTag/${TagKey}

AuthorizeIpRules 授予向 IP 访问控制组添加规则的权限 Write

workspaceipgroup*

workspaces:UpdateRulesOfIpGroup

CopyWorkspaceImage 授予复制 WorkSpace 映像的权限 Write

workspaceimage*

workspaces:DescribeWorkspaceImages

aws:RequestTag/${TagKey}

aws:TagKeys

CreateConnectClientAddIn 授予在目录内创建 Amazon Connect 客户端插件的权限 Write

directoryid*

CreateConnectionAlias 授予创建连接别名以用于跨区域重定向的权限 Write

aws:RequestTag/${TagKey}

aws:TagKeys

CreateIpGroup 授予创建 IP 访问控制组的权限 Write

aws:RequestTag/${TagKey}

aws:TagKeys

CreateStandbyWorkspaces 授予权限以创建一个或多个 Standby WorkSpaces Write

directoryid*

workspaceid*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateTags 授予为 WorkSpaces 资源创建标签的权限 Tagging

aws:RequestTag/${TagKey}

aws:TagKeys

CreateUpdatedWorkspaceImage 授予创建更新的 WorkSpace 镜像的权限 Write

workspaceimage*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateWorkspaceBundle 授予创建 WorkSpace 捆绑包的权限 Write

workspacebundle*

workspaces:CreateTags

workspaceimage*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateWorkspaceImage 授予权限以创建新的 WorkSpace 映像 Write

workspaceid*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateWorkspaces 授予创建一个或多个 WorkSpace 的权限 Write

directoryid*

workspacebundle*

workspaceid*

aws:RequestTag/${TagKey}

aws:TagKeys

DeleteClientBranding 授予权限以删除目录中的 Amazon WorkSpaces Client 品牌数据 Write

directoryid*

DeleteConnectClientAddIn 授予删除目录内配置的 Amazon Connect 客户端插件的权限 Write

directoryid*

DeleteConnectionAlias 授予删除连接别名的权限 Write

connectionalias*

DeleteIpGroup 授予删除 IP 访问控制组的权限 Write

workspaceipgroup*

DeleteTags 授予从 WorkSpaces 资源中删除标签的权限 Tagging

aws:RequestTag/${TagKey}

aws:TagKeys

DeleteWorkspaceBundle 授予删除 WorkSpace 捆绑包的权限 Write

workspacebundle*

DeleteWorkspaceImage 授予删除 WorkSpace 映像的权限 Write

workspaceimage*

DeployWorkspaceApplications 授予在 WorkSpace 上部署所有待处理的工作空间应用程序的权限 Write

workspaceid*

aws:ResourceTag/${TagKey}

DeregisterWorkspaceDirectory 授予取消注册目录使其不能在 Amazon WorkSpaces 中使用的权限 Write

directoryid*

DescribeAccount 授予检索 WorkSpaces 账户的自带许可 (BYOL) 配置的权限 Read
DescribeAccountModifications 授予检索对 WorkSpaces 账户的自带许可 (BYOL) 配置的修改的权限 Read
DescribeApplicationAssociations 授予权限以检索与 WorkSpace 应用程序关联的资源的相关信息 List

workspaceapplication*

aws:ResourceTag/${TagKey}

DescribeApplications 授予权限以获取有关 WorkSpace 应用程序的信息 List
DescribeBundleAssociations 授予权限以检索与 WorkSpace 捆绑包关联的资源的相关信息 List

workspacebundle*

aws:ResourceTag/${TagKey}

DescribeClientBranding 授予权限以检索目录中的 Amazon WorkSpaces Client 品牌数据 Read

directoryid*

DescribeClientProperties 授予权限以检索有关 WorkSpaces 客户端的信息 List

directoryid*

DescribeConnectClientAddIns 授予检索已创建的 Amazon Connect 客户端插件列表的权限 List

directoryid*

DescribeConnectionAliasPermissions 授予权限以检索连接别名所有者为连接别名的其他Amazon账户授予的权限 Read

connectionalias*

DescribeConnectionAliases 授予检索描述用于跨区域重定向的连接别名的列表的权限 Read
DescribeImageAssociations 授予权限以检索与 WorkSpace 映像关联的资源的相关信息 List

workspaceimage*

aws:ResourceTag/${TagKey}

DescribeIpGroups 授予权限以检索有关 IP 访问控制组的信息 Read

workspaceipgroup*

DescribeTags 授予描述 WorkSpaces 资源标签的权限 Read
DescribeWorkspaceAssociations 授予权限以检索与 WorkSpace 关联的资源的相关信息 List

workspaceid*

aws:ResourceTag/${TagKey}

DescribeWorkspaceBundles 授予获取有关 WorkSpace 捆绑包信息的权限 List
DescribeWorkspaceDirectories 授予检索有关在 WorkSpaces 中注册的目录的信息的权限 Read
DescribeWorkspaceImagePermissions 授予检索有关 WorkSpace 映像权限信息的权限 Read

workspaceimage*

DescribeWorkspaceImages 授予权限以检索有关 WorkSpace 映像的信息 List
DescribeWorkspaceSnapshots 授予权限以检索有关 WorkSpace 快照的信息 List

workspaceid*

DescribeWorkspaces 授予获取有关 WorkSpaces 信息的权限 List
DescribeWorkspacesConnectionStatus 授予获取 WorkSpaces 连接状态的权限 Read
DisassociateConnectionAlias 授予取消连接别名与目录的关联的权限 Write

connectionalias*

DisassociateIpGroups 授予取消 IP 访问控制组与目录的关联的权限 Write

directoryid*

workspaceipgroup*

DisassociateWorkspaceApplication 授予权限以将工作空间应用程序与 WorkSpace 解除关联 Write

workspaceapplication*

workspaceid*

aws:ResourceTag/${TagKey}

ImportClientBranding 授予权限以导入目录中的 Amazon WorkSpaces Client 品牌数据 Write

directoryid*

ImportWorkspaceImage 授予将自带许可 (BYOL) 映像导入 Amazon WorkSpaces 的权限 Write

ec2:DescribeImages

ec2:ModifyImageAttribute

ListAvailableManagementCidrRanges 授予列出可用 CIDR 范围的权限，以便为 WorkSpaces 账户启用自带许可 (BYOL) List
MigrateWorkspace 授予迁移 WorkSpaces 的权限 Write

workspacebundle*

workspaceid*

ModifyAccount 授予修改 WorkSpaces 账户的自带许可 (BYOL) 配置的权限 Write
ModifyCertificateBasedAuthProperties 授予权限以修改目录的基于证书的授权属性 Write

directoryid*

ModifyClientProperties 授予修改 WorkSpaces 客户端的属性的权限 Write

directoryid*

ModifySamlProperties 授予权限以修改目录的 SAML 属性 Write

directoryid*

ModifySelfservicePermissions 授予修改用户的自助 WorkSpace 管理功能的权限 Permissions management

directoryid*

ModifyWorkspaceAccessProperties 授予权限以指定用户可以使用哪些设备和操作系统访问其 WorkSpaces Write

directoryid*

ModifyWorkspaceCreationProperties 授予修改用于创建 WorkSpaces 的默认属性的权限 Write

directoryid*

ModifyWorkspaceProperties 授予修改 WorkSpace 属性的权限，包括运行模式和 AutoStop 周期 Write

workspaceid*

ModifyWorkspaceState 授予修改 WorkSpaces 状态的权限 Write

workspaceid*

RebootWorkspaces 授予重新引导 WorkSpaces 的权限 Write

workspaceid*

RebuildWorkspaces 授予重建 WorkSpaces 的权限 Write

workspaceid*

RegisterWorkspaceDirectory 授予注册目录以便在 Amazon WorkSpaces 中使用的权限 Write

directoryid*

aws:RequestTag/${TagKey}

aws:TagKeys

RestoreWorkspace 授予恢复 WorkSpaces 的权限 Write

workspaceid*

RevokeIpRules 授予从 IP 访问控制组中删除规则的权限 Write

workspaceipgroup*

workspaces:UpdateRulesOfIpGroup

StartWorkspaces 授予启动 AutoStop WorkSpaces 的权限 Write

workspaceid*

StopWorkspaces 授予停止 AutoStop WorkSpaces 的权限 Write

workspaceid*

Stream 向联合用户授予使用现有凭证登录和流式传输 WorkSpace 的权限 Write

directoryid*

workspaces:userId

TerminateWorkspaces 授予终止 WorkSpaces 的权限 Write

workspaceid*

UpdateConnectClientAddIn 授予更新 Amazon Connect 客户端插件的权限。使用此操作更新 Amazon Connect 客户端插件的名称和端点 URL Write

directoryid*

UpdateConnectionAliasPermission 授予与其他账户共享或取消共享连接别名的权限 Permissions management

connectionalias*

UpdateRulesOfIpGroup 授予替换 IP 访问控制组规则的权限 Write

workspaceipgroup*

workspaces:AuthorizeIpRules

workspaces:RevokeIpRules

UpdateWorkspaceBundle 授予更新 WorkSpace 捆绑包中使用的 WorkSpace 映像的权限 Write

workspacebundle*

workspaceimage*

UpdateWorkspaceImagePermission 通过指定其他账户是否有权复制映像，授予与其他账户共享或取消共享 WorkSpace 映像的权限 Permissions management

workspaceimage*

Amazon WorkSpaces 定义的资源类型

以下资源类型是由该服务定义的，可以在 IAM 权限策略语句的 Resource 元素中使用这些资源类型。操作表中的每个操作指定了可以使用该操作指定的资源类型。您也可以在策略中包含条件键，从而定义资源类型。这些键显示在资源类型表的最后一列。有关下表中各列的详细信息，请参阅资源类型表。

资源类型 ARN 条件键
directoryid arn:${Partition}:workspaces:${Region}:${Account}:directory/${DirectoryId}

aws:ResourceTag/${TagKey}

workspacebundle arn:${Partition}:workspaces:${Region}:${Account}:workspacebundle/${BundleId}

aws:ResourceTag/${TagKey}

workspaceid arn:${Partition}:workspaces:${Region}:${Account}:workspace/${WorkspaceId}

aws:ResourceTag/${TagKey}

workspaceimage arn:${Partition}:workspaces:${Region}:${Account}:workspaceimage/${ImageId}

aws:ResourceTag/${TagKey}

workspaceipgroup arn:${Partition}:workspaces:${Region}:${Account}:workspaceipgroup/${GroupId}

aws:ResourceTag/${TagKey}

connectionalias arn:${Partition}:workspaces:${Region}:${Account}:connectionalias/${ConnectionAliasId}

aws:ResourceTag/${TagKey}

workspaceapplication arn:${Partition}:workspaces:${Region}:${Account}:workspaceapplication/${WorkSpaceApplicationId}

aws:ResourceTag/${TagKey}

Amazon WorkSpaces 的条件键

Amazon WorkSpaces 定义以下可在 IAM policy 的 Condition 元素中使用的条件键。您可以使用这些键进一步细化应用策略语句的条件。有关下表中各列的详细信息，请参阅条件键表。

要查看适用于所有服务的全局条件键，请参阅可用的全局条件键。

条件键 描述 类型
aws:RequestTag/${TagKey} 根据在请求中传递的标签筛选访问 字符串
aws:ResourceTag/${TagKey} 根据与资源关联的标签筛选访问 字符串
aws:TagKeys 根据在请求中传递的标签键筛选访问 字符串数组
workspaces:userId 按 WorkSpace 用户的 ID 筛选访问权限 字符串