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

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

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

参考：

Amazon WorkSpaces 定义的操作

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

操作表的访问级别列描述如何对操作进行分类（列出、读取、权限管理或标记）。此分类可以帮助您了解当您在策略中使用操作时，相应操作授予的访问级别。有关访问级别的更多信息，请参阅策略摘要中的访问级别。

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

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

操作表的依赖操作列显示成功调用操作可能需要的其他权限。除了操作本身的权限以外，可能还需要这些权限。若某个操作指定依赖操作，则这些依赖关系可能适用于为该操作定义的其他资源，而不仅仅是表中列出的第一个资源。

注意

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

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

操作 描述 访问级别 资源类型（* 为必需） 条件键 相关操作
AcceptAccountLinkInvitation 授予权限以接受来自其他 Amazon 账户的邀请来共享 WorkSpaces BYOL 的相同配置 写入
AssociateConnectionAlias 授予将连接别名与目录关联的权限 Write

connectionalias*

directoryid*

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

directoryid*

workspaceipgroup*

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

workspaceapplication*

workspaceid*

aws:ResourceTag/${TagKey}

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

workspaceipgroup*

workspaces:UpdateRulesOfIpGroup

CopyWorkspaceImage 授予复制 WorkSpace 映像的权限 写入

workspaceimage*

workspaces:DescribeWorkspaceImages

aws:RequestTag/${TagKey}

aws:TagKeys

CreateAccountLinkInvitation 授予权限以邀请其他 Amazon 账户共享 WorkSpaces BYOL 的相同配置 写入
CreateConnectClientAddIn 授予在目录内创建 Amazon Connect 客户端插件的权限 写入

directoryid*

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

aws:RequestTag/${TagKey}

aws:TagKeys

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

aws:RequestTag/${TagKey}

aws:TagKeys

CreateRootClientCertificate [仅权限] 授予权限以创建根客户端证书 写入

certificateid*

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

directoryid*

workspaceid*

aws:RequestTag/${TagKey}

aws:TagKeys

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

aws:RequestTag/${TagKey}

aws:TagKeys

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

workspaceimage*

aws:RequestTag/${TagKey}

aws:TagKeys

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

workspacebundle*

workspaces:CreateTags

workspaceimage*

aws:RequestTag/${TagKey}

aws:TagKeys

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

workspaceid*

aws:RequestTag/${TagKey}

aws:TagKeys

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

directoryid*

workspacebundle*

workspaceid*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateWorkspacesPool 授予权限以创建 WorkSpaces Pool 写入

directoryid*

workspacebundle*

workspacespoolid*

aws:RequestTag/${TagKey}

aws:TagKeys

DeleteAccountLinkInvitation 授予权限以取消邀请其他 Amazon 账户共享 WorkSpaces BYOL 的相同配置 写入
DeleteClientBranding 授予权限以删除目录中的 Amazon WorkSpaces Client 品牌数据 写入

directoryid*

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

directoryid*

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

connectionalias*

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

workspaceipgroup*

DeleteRootClientCertificate [仅权限] 授予权限以删除根客户端证书 写入

certificateid*

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

aws:RequestTag/${TagKey}

aws:TagKeys

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

workspacebundle*

DeleteWorkspaceImage 授予删除 WorkSpace 映像的权限 写入

workspaceimage*

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

workspaceid*

aws:ResourceTag/${TagKey}

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

directoryid*

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

workspaceapplication*

aws:ResourceTag/${TagKey}

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

workspacebundle*

aws:ResourceTag/${TagKey}

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

directoryid*

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

directoryid*

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

directoryid*

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

connectionalias*

DescribeConnectionAliases 授予检索描述用于跨区域重定向的连接别名的列表的权限 读取
DescribeConsent [仅权限] 授予权限以检索有关 BYOL 最低要求的同意协议的信息 读取
DescribeCustomWorkspaceImageImport 授予权限以检索有关 WorkSpace BYOL 映像导入任务的信息 读取
DescribeImageAssociations 授予权限以检索与 WorkSpace 映像关联的资源的相关信息 列表

workspaceimage*

aws:ResourceTag/${TagKey}

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

workspaceipgroup*

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

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 连接状态的权限 读取
DescribeWorkspacesPoolSessions 授予权限以检索有关 WorkSpaces Pool 会话的信息 列表

workspacespoolid*

DescribeWorkspacesPools 授予权限以检索有关 WorkSpaces Pool 的信息 列表
DirectoryAccessManagement [仅权限] 授予权限以在管理和预置工作区时执行目录管理操作 列表

directoryid*

DisassociateConnectionAlias 授予取消连接别名与目录的关联的权限 Write

connectionalias*

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

directoryid*

workspaceipgroup*

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

workspaceapplication*

workspaceid*

aws:ResourceTag/${TagKey}

授予权限以检索与其他 Amazon 账户的链接以共享 WorkSpaces BYOL 的配置 读取
ImportClientBranding 授予权限以导入目录中的 Amazon WorkSpaces Client 品牌数据 写入

directoryid*

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

ec2:DescribeImages

ec2:ModifyImageAttribute

授予权限以检索与 Amazon 账户的链接，共享您的 WorkSpaces BYOL 配置 列表
ListAvailableManagementCidrRanges 授予列出可用 CIDR 范围的权限，以便为 WorkSpaces 账户启用自带许可 (BYOL) List
MigrateWorkspace 授予迁移 WorkSpaces 的权限 Write

workspacebundle*

workspaceid*

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

directoryid*

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

directoryid*

ModifyEndpointEncryptionMode 授予权限以在标准 TLS 和 FIPS 140-2 验证模式之间配置指定目录 写入

directoryid*

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

directoryid*

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

directoryid*

ModifyStreamingProperties 授予权限以修改流属性 写入

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 中使用的权限 写入

directoryid*

aws:RequestTag/${TagKey}

aws:TagKeys

RejectAccountLinkInvitation 授予权限以拒绝来自其他 Amazon 账户的共享 WorkSpaces BYOL 相同配置的邀请 写入
RestoreWorkspace 授予恢复 WorkSpaces 的权限 Write

workspaceid*

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

workspaceipgroup*

workspaces:UpdateRulesOfIpGroup

StartWorkspaces 授予启动 AutoStop WorkSpaces 的权限 写入

workspaceid*

StartWorkspacesPool 授予权限以启动 WorkSpaces Pool 写入

workspacespoolid*

StopWorkspaces 授予停止 AutoStop WorkSpaces 的权限 写入

workspaceid*

StopWorkspacesPool 授予权限以停止 AutoStop WorkSpaces 写入

workspacespoolid*

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

directoryid*

workspaces:userId

TerminateWorkspaces 授予终止 WorkSpaces 的权限 写入

workspaceid*

TerminateWorkspacesPool 授予权限以终止 WorkSpaces Pool 写入

workspacespoolid*

TerminateWorkspacesPoolSession 授予权限以终止 WorkSpaces Pool 会话 写入
UpdateConnectClientAddIn 授予更新 Amazon Connect 客户端插件的权限。使用此操作更新 Amazon Connect 客户端插件的名称和端点 URL 写入

directoryid*

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

connectionalias*

UpdateConsent [仅权限] 授予权限以更新 BYOL 最低要求的同意协议 写入
UpdateRootClientCertificate [仅权限] 授予权限以更新根客户端证书 写入

certificateid*

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

workspaceipgroup*

workspaces:AuthorizeIpRules

workspaces:RevokeIpRules

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

workspacebundle*

workspaceimage*

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

workspaceimage*

UpdateWorkspacesPool 授予权限以更新 WorkSpaces Pool 写入

workspacespoolid*

Amazon WorkSpaces 定义的资源类型

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

资源类型 ARN 条件键
certificateid arn:${Partition}:workspaces:${Region}:${Account}:workspacecertificate/${CertificateId}
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}

workspacespoolid arn:${Partition}:workspaces:${Region}:${Account}:workspacespool/${PoolId}

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 元素中使用的条件键。您可以使用这些键进一步细化应用策略语句的条件。有关下表中各列的详细信息，请参阅条件键表。

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

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