

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Amazon EC2 Instance Connect 的操作、资源和条件键
<a name="list_ec2-instance-connect"></a>

亚马逊 EC2 实例连接（服务前缀： `ec2-instance-connect`) 提供以下特定服务的操作、资源、操作和条件密钥，用于 IAM 权限策略。

参考：
+ 了解如何[配置该服务](https://docs.amazonaws.cn/AWSEC2/latest/UserGuide/)。
+ 查看[适用于该服务的 API 操作列表](https://docs.amazonaws.cn/ec2-instance-connect/latest/APIReference/Welcome.html)。
+ 了解如何[使用 IAM](https://docs.amazonaws.cn/AWSEC2/latest/UserGuide/security-iam.html) 权限策略保护该服务及其资源。
+ 查看 [编程服务授权参考](https://servicereference.us-east-1.amazonaws.com/v1/ec2-instance-connect/ec2-instance-connect.json) 用于此服务。

**Topics**
+ [亚马逊 EC2 实例连接定义的 API 操作](#list_ec2-instance-connect-operations)
+ [Amazon EC2 Instance Connect 定义的操作](#list_ec2-instance-connect-actions-as-permissions)
+ [Amazon EC2 Instance Connect 定义的资源类型](#list_ec2-instance-connect-resources-for-iam-policies)
+ [Amazon EC2 Instance Connect 的条件键](#list_ec2-instance-connect-policy-keys)

## 亚马逊 EC2 实例连接定义的 API 操作
<a name="list_ec2-instance-connect-operations"></a>

下表将 API 操作映射到它们授权的 IAM 操作。仅列出具有给定 API 和操作静态值的条件密钥；有关每个操作支持的全套条件密钥，请参阅 [操作表](#list_ec2-instance-connect-actions-as-permissions)。




- **   SendSSHPublicKey  **
  - **IAM 操作:**  [ec2-instance-connect:SendSSHPublicKey](#list_ec2-instance-connect-action-SendSSHPublicKey) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 写入

- **   SendSerialConsoleSSHPublicKey  **
  - **IAM 操作:**  [ec2-instance-connect:SendSerialConsoleSSHPublicKey](#list_ec2-instance-connect-action-SendSerialConsoleSSHPublicKey) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 写入



## Amazon EC2 Instance Connect 定义的操作
<a name="list_ec2-instance-connect-actions-as-permissions"></a>

您可以在 IAM 策略语句的 `Action` 元素中指定以下操作。对于每个操作，该表列出了该操作支持的资源类型和条件键。可以使用策略授予在 Amazon中执行操作的权限。您在策略中使用一项操作时，通常使用相同的名称允许或拒绝对 API 操作或 CLI 命令的访问。但在某些情况下，单一动作可控制对多项操作的访问。还有某些操作需要多种不同的动作。




- **   [OpenTunnel](https://docs.amazonaws.cn/AWSEC2/latest/UserGuide/permissions-for-ec2-instance-connect-endpoint.html#iam-OpenTunnel)  **
  - **说明:** 授予权限以使用 EC2 Instance Connect Endpoint 建立指向 EC2 实例的 SSH 连接
  - **资源类型（\* 为必需）:** [instance-connect-endpoint\*](#list_ec2-instance-connect-resource-instance-connect-endpoint) / **条件键:** [aws:ResourceTag/${TagKey}](#list_ec2-instance-connect-aws_ResourceTag___TagKey_)<br />[ec2:ResourceTag/${TagKey}](#list_ec2-instance-connect-ec2_ResourceTag___TagKey_)
  - **资源类型（\* 为必需）:** [instance-connect-endpoint\*](#list_ec2-instance-connect-resource-instance-connect-endpoint) / **条件键:** [aws:ResourceTag/${TagKey}](#list_ec2-instance-connect-aws_ResourceTag___TagKey_)<br />ec2-instance-connect:MaxTunnelDuration<br />[ec2-instance-connect:privateIpAddress](#list_ec2-instance-connect-ec2-instance-connect_privateIpAddress)<br />[ec2-instance-connect:remotePort](#list_ec2-instance-connect-ec2-instance-connect_remotePort)<br />[ec2:ResourceTag/${TagKey}](#list_ec2-instance-connect-ec2_ResourceTag___TagKey_)
  - **访问级别:** 写入

- **   [SendSSHPublicKey](https://docs.amazonaws.cn/ec2-instance-connect/latest/APIReference/API_SendSSHPublicKey.html)  **
  - **说明:** 授予权限以将 SSH 公有密钥推送到用于标准 SSH 的指定 EC2 实例
  - **资源类型（\* 为必需）:** [instance\*](#list_ec2-instance-connect-resource-instance)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_ec2-instance-connect-aws_ResourceTag___TagKey_)<br />[ec2:osuser](#list_ec2-instance-connect-ec2_osuser)<br />[ec2:ResourceTag/${TagKey}](#list_ec2-instance-connect-ec2_ResourceTag___TagKey_)
  - **访问级别:** 写入

- **   [SendSerialConsoleSSHPublicKey](https://docs.amazonaws.cn/ec2-instance-connect/latest/APIReference/API_SendSerialConsoleSSHPublicKey.html)  **
  - **说明:** 授予权限以将 SSH 公有密钥推送到用于串行控制台 SSH 的指定 EC2 实例
  - **资源类型（\* 为必需）:** [instance\*](#list_ec2-instance-connect-resource-instance)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_ec2-instance-connect-aws_ResourceTag___TagKey_)<br />[ec2:ResourceTag/${TagKey}](#list_ec2-instance-connect-ec2_ResourceTag___TagKey_)
  - **访问级别:** 写入



## Amazon EC2 Instance Connect 定义的资源类型
<a name="list_ec2-instance-connect-resources-for-iam-policies"></a>

以下资源类型是由该服务定义的，可以在 IAM 权限策略语句的 `Resource` 元素中使用这些资源类型。



| 资源类型 | ARN | 条件键 | 
| --- | --- | --- | 
|  [instance](https://docs.amazonaws.cn/AWSEC2/latest/UserGuide/iam-policy-structure.html#EC2_ARN_Format)  | arn:${Partition}:ec2:${Region}:${Account}:instance/${InstanceId} | [aws:ResourceTag/${TagKey}](#list_ec2-instance-connect-aws_ResourceTag___TagKey_)<br />[ec2:ResourceTag/${TagKey}](#list_ec2-instance-connect-ec2_ResourceTag___TagKey_) | 
|  [instance-connect-endpoint](https://docs.amazonaws.cn/AWSEC2/latest/UserGuide/permissions-for-ec2-instance-connect-endpoint.html#iam-CreateInstanceConnectEndpoint)  | arn:${Partition}:ec2:${Region}:${Account}:instance-connect-endpoint/${InstanceConnectEndpointId} | [aws:ResourceTag/${TagKey}](#list_ec2-instance-connect-aws_ResourceTag___TagKey_)<br />[ec2:ResourceTag/${TagKey}](#list_ec2-instance-connect-ec2_ResourceTag___TagKey_) | 

## Amazon EC2 Instance Connect 的条件键
<a name="list_ec2-instance-connect-policy-keys"></a>

Amazon EC2 Instance Connect 定义以下可以在 IAM policy 的 `Condition` 元素中使用的条件键。



| 条件键 | 描述 | 类型 | 
| --- | --- | --- | 
|   [aws:ResourceTag/${TagKey}](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-resourcetag)  | 按与资源关联的标签筛选访问权限 | String | 
|   [ec2-instance-connect:maxTunnelDuration](https://docs.amazonaws.cn/AWSEC2/latest/UserGuide/permissions-for-ec2-instance-connect-endpoint.html#iam-OpenTunnel)  | 按与实例关联的最大会话持续时间筛选访问权限 | Numeric | 
|   [ec2-instance-connect:privateIpAddress](https://docs.amazonaws.cn/AWSEC2/latest/UserGuide/permissions-for-ec2-instance-connect-endpoint.html#iam-OpenTunnel)  | 按与实例关联的私有 IP 地址筛选访问权限 | IPAddress | 
|   [ec2-instance-connect:remotePort](https://docs.amazonaws.cn/AWSEC2/latest/UserGuide/permissions-for-ec2-instance-connect-endpoint.html#iam-OpenTunnel)  | 按与实例关联的端口号筛选访问权限 | Numeric | 
|   [ec2:ResourceTag/${TagKey}](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-resourcetag)  | 按与资源关联的标签筛选访问权限 | String | 
|   [ec2:osuser](https://docs.amazonaws.cn/ec2-instance-connect/latest/APIReference/API_SendSSHPublicKey.html)  | 通过指定用于启动实例的 AMI 的默认用户名来筛选访问 | String | 