AWS IoT Greengrass V2 的操作、资源和条件键
AWS IoT Greengrass V2（服务前缀：greengrass）提供以下服务特定的资源、操作和条件上下文键以在 IAM 权限策略中使用。
参考：
AWS IoT Greengrass V2 定义的操作
您可以在 IAM 策略语句的 Action 元素中指定以下操作。可以使用策略授予在 AWS 中执行操作的权限。您在策略中使用一项操作时，通常使用相同的名称允许或拒绝对 API 操作或 CLI 命令的访问。但在某些情况下，单一动作可控制对多项操作的访问。还有某些操作需要多种不同的动作。
操作表的资源类型列指示每项操作是否支持资源级权限。如果该列没有任何值，您必须在策略语句的 Resource 元素中指定策略应用的所有资源（“*”）。通过在 IAM policy 中使用条件来筛选访问权限，以控制是否可以在资源或请求中使用特定标签键。如果操作具有一个或多个必需资源，则调用方必须具有使用这些资源来使用该操作的权限。必需资源在表中以星号 (*) 表示。如果您在 IAM policy 中使用 Resource 元素限制资源访问权限，则必须为每种必需的资源类型添加 ARN 或模式。某些操作支持多种资源类型。如果资源类型是可选的（未指示为必需），则可以选择使用一种可选资源类型。
操作表的条件键列包括可以在策略语句的 Condition 元素中指定的键。有关与服务资源关联的条件键的更多信息，请参阅资源类型表的条件键列。
注意
资源条件键在资源类型表中列出。您可以在操作表的资源类型（* 为必需）列中找到应用于某项操作的资源类型的链接。资源类型表中的资源类型包括条件密钥列，这是应用于操作表中操作的资源条件键。
有关下表中各列的详细信息，请参阅操作表。
| 操作 | 描述 | 访问级别 | 资源类型（* 为必需） | 条件键 | 相关操作 |
|---|---|---|---|---|---|
| AssociateServiceRoleToAccount | 授予权限以将角色与您的账户相关联。AWSIoT Greengrass 使用该角色访问您的 Lambda 函数和 AWS IoT 资源 | 权限管理 |
iam:PassRole |
||
| BatchAssociateClientDeviceWithCoreDevice | 授予权限以将客户端设备列表与核心设备关联 | 写入 | |||
| BatchDisassociateClientDeviceFromCoreDevice | 授予权限以取消客户端设备列表与核心设备的关联 | 写入 | |||
| CancelDeployment | 授予取消部署的权限 | Write |
iot:CancelJob iot:DeleteThingShadow iot:DescribeJob iot:DescribeThing iot:DescribeThingGroup iot:GetThingShadow iot:UpdateJob iot:UpdateThingShadow |
||
| CreateComponentVersion | 授予创建组件的权限 | Write | |||
| CreateDeployment | 授予创建部署的权限 | Write |
iot:CancelJob iot:CreateJob iot:DeleteThingShadow iot:DescribeJob iot:DescribeThing iot:DescribeThingGroup iot:GetThingShadow iot:UpdateJob iot:UpdateThingShadow |
||
| DeleteComponent | 授予删除组件的权限 | Write | |||
| DeleteCoreDevice | 授予删除 AWS IoT Greengrass 核心设备（一种 AWS IoT 事物）的权限 。此操作将从核心设备列表中删除该核心设备。此操作不会删除 AWS IoT 事物 | 写入 |
iot:DescribeJobExecution |
||
| DeleteDeployment | 授予权限以删除部署。要删除活动部署，需要先将其取消 | 写入 |
iot:DeleteJob |
||
| DescribeComponent | 授予检索组件版本元数据的权限 | 读取 | |||
| DisassociateServiceRoleFromAccount | 授予权限以将服务角色与账户取消关联。如果没有服务角色，部署将不起作用 | 写入 | |||
| GetComponent | 授予获取组件版本配方的权限 | Read | |||
| GetComponentVersionArtifact | 授予获取预签名 URL 以下载公有组件的权限 | 读取 | |||
| GetConnectivityInfo | 授予权限以检索 Greengrass 核心设备的连接信息 | 读取 |
iot:GetThingShadow |
||
| GetCoreDevice | 授予检索 AWS IoT Greengrass 核心设备元数据的权限 | Read | |||
| GetDeployment | 授予获取部署的权限 | 读取 |
iot:DescribeJob iot:DescribeThing iot:DescribeThingGroup iot:GetThingShadow |
||
| GetServiceRoleForAccount | 授予权限以检索附加到账户的服务角色 | 读取 | |||
| ListClientDevicesAssociatedWithCoreDevice | 授予权限以检索与 AWS IoT Greengrass 核心设备关联的客户端设备的分页列表 | 列出 | |||
| ListComponentVersions | 授予检索组件所有版本的分页列表的权限 | List | |||
| ListComponents | 授予检索组件摘要的分页列表的权限 | List | |||
| ListCoreDevices | 授予检索 AWS IoT Greengrass 核心设备的分页列表的权限 | List | |||
| ListDeployments | 授予检索部署分页列表的权限 | List |
iot:DescribeJob iot:DescribeThing iot:DescribeThingGroup iot:GetThingShadow |
||
| ListEffectiveDeployments | 授予检索 AWS IoT Greengrass 发送到 AWS IoT Greengrass 核心设备的部署作业分页列表的权限 | List |
iot:DescribeJob iot:DescribeJobExecution iot:DescribeThing iot:DescribeThingGroup iot:GetThingShadow |
||
| ListInstalledComponents | 授予检索 AWS IoT Greengrass 核心设备所运行的组件分页列表的权限 | List | |||
| ListTagsForResource | 授予列出资源标签的权限 | 读取 | |||
| ResolveComponentCandidates | 授予列出符合部署组件、版本和平台要求的组件的权限 | List | |||
| TagResource | 授予权限以将标签添加到资源中 | Tagging | |||
| UntagResource | 授予权限以从资源中删除标签 | Tagging | |||
| UpdateConnectivityInfo | 授予权限以更新 Greengrass 核心的连接信息。属于具有该核心的组的任何设备都会收到该信息，以便查找该核心的位置并连接到该核心 | 写入 |
iot:GetThingShadow iot:UpdateThingShadow |
AWS IoT Greengrass V2 定义的资源类型
以下资源类型是由该服务定义的，可以在 IAM 权限策略语句的 Resource 元素中使用这些资源类型。操作表中的每个操作指定了可以使用该操作指定的资源类型。您也可以在策略中包含条件键，从而定义资源类型。这些键显示在资源类型表的最后一列。有关下表中各列的详细信息，请参阅资源类型表。
| 资源类型 | ARN | 条件键 |
|---|---|---|
| connectivityInfo |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/things/${ThingName}/connectivityInfo
|
|
| component |
arn:${Partition}:greengrass:${Region}:${Account}:components:${ComponentName}
|
|
| componentVersion |
arn:${Partition}:greengrass:${Region}:${Account}:components:${ComponentName}:versions:${ComponentVersion}
|
|
| coreDevice |
arn:${Partition}:greengrass:${Region}:${Account}:coreDevices:${CoreDeviceThingName}
|
|
| deployment |
arn:${Partition}:greengrass:${Region}:${Account}:deployments:${DeploymentId}
|
AWS IoT Greengrass V2 的条件键
AWS IoT Greengrass V2 定义了下列可以在 IAM policy 的 Condition 元素中使用的条件键。您可以使用这些键进一步细化应用策略语句的条件。有关下表中各列的详细信息，请参阅条件键表。
要查看适用于所有服务的全局条件键，请参阅可用的全局条件键。
| 条件键 | 描述 | 类型 |
|---|---|---|
| aws:RequestTag/${TagKey} | 通过检查请求中包含的标签键值对筛选访问权限 | String |
| aws:ResourceTag/${TagKey} | 通过检查与特定资源关联的标签键/值对筛选访问权限 | String |
| aws:TagKeys | 通过检查请求中传递的标签键筛选访问权限 | 字符串数组 |
