

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

# 共享音量
<a name="share-volume"></a>

你可以使用 Amazon Resource Access Manager （Amazon RAM) 与其他人共享亚马逊 EBS 交易量 Amazon 账户。共享卷后，消费账户可以在同一个可用区内查看卷信息并创建共享卷的副本。有关创建副本的更多信息，请参阅 [复制 Amazon EBS 卷](ebs-copying-volume.md)。消费账户无法附加、修改、删除或创建共享卷的快照。

例如，您可以与开发账户共享生产量，使用最新的生产数据刷新测试环境，同时保持账户级隔离。

您可以共享以下音量：
+ 未加密
+ 使用客户管理的密钥加密

您无法共享使用默认加密的卷 Amazon 亚马逊 EBS 的管理密钥。

**Topics**
+ [Permissions](#share-volume-permissions)
+ [共享音量](#share-volume-procedure)
+ [查看共享卷](#view-shared-volumes)
+ [共享音量的注意事项](#share-volume-considerations)
+ [监控共享活动](#share-volume-monitoring)
+ [共享卷和回收站](#shared-volumes-recycle-bin)
+ [定价](#share-volume-pricing)

## Permissions
<a name="share-volume-permissions"></a>

为共享卷创建资源共享时，必须将托管权限与资源共享关联起来。托管权限决定使用账户可以在资源共享中的共享卷上执行哪些操作。 Amazon RAM 提供以下内容 Amazon 托管权限：
+ **AWSRAMDefaultPermissionEBSVolume** （默认）— 授予消费账户查看交易量信息的权限。
+ **AWSRAMPermissionEBSVolumeCopyAccess** — 授予使用者账户查看卷信息和创建共享卷副本的权限。

或者，您可以为创建客户管理权限 `ec2:Volume` 资源类型。有关更多信息，请参阅*《Amazon RAM 用户指南》*中的[创建和使用客户托管权限](https://docs.amazonaws.cn/ram/latest/userguide/create-customer-managed-permissions.html)。

## 共享音量
<a name="share-volume-procedure"></a>

使用以下方法之一共享亚马逊 EBS 卷。

------
#### [ Console ]

**共享音量**

1. 在以下位置打开亚马逊弹性计算云控制台 [https://console.amazonaws.cn/ec2/](https://console.amazonaws.cn/ec2/)。

1. 在导航窗格中，选择 **Volumes**。

1. 选择音量，然后选择 **行动**， **分享音量**。

1. 请执行以下操作之一：
   + 要将卷添加到现有资源共享，请选择资源共享。
   + 要创建新的资源共享，请选择 **创建新的资源共享**。这会打开 Amazon RAM 控制台，您可以在其中配置共享。

1. 对于 **校长**，添加要与之共享音量的账户。您可以添加个人账户 ID、组织单位 (OU) 或整个组织。

1. 对于 **托管权限**，选择以下选项之一：
   + **AWSRAMDefaultPermissionEBSVolume** （默认）— 消费账户只能查看音量元数据。
   + **AWSRAMPermissionEBSVolumeCopyAccess** — 消费账户可以查看卷元数据并创建共享卷的副本。
   + 您为创建的客户管理权限 `ec2:Volume` 资源类型。

1. 选择**创建资源共享**。

------
#### [ Amazon CLI ]

使用 [create-resource-share](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/create-resource-share.html) 命令。指定批量 ARN、消费账户和权限 ARN。要查找音量 ARN，请致电 [描述音量](https://docs.amazonaws.cn/cli/latest/reference/ec2/describe-volumes.html)。该回应包括 `VolumeArn` 每个卷的字段。

以下示例创建了共享交易量的资源共享 `vol-1234567890abcdef0` 带账号 `444455556666`，并分配 `AWSRAMPermissionEBSVolumeCopyAccess` 管理权限：

```
aws ram create-resource-share \
--name {{my-volume-share}} \
--resource-arns {{arn:aws:ec2:us-east-1:111122223333:volume/vol-1234567890abcdef0}} \
--principals {{444455556666}} \
--permission-arns {{arn:aws:ram::aws:permission/AWSRAMPermissionEBSVolumeCopyAccess}} \
--region {{us-east-1}}
```

使用默认权限共享 (`AWSRAMDefaultPermissionEBSVolume`，仅描述），省略 `--permission-arns` 参数:

```
aws ram create-resource-share \
--name {{my-volume-share}} \
--resource-arns {{arn:aws:ec2:us-east-1:111122223333:volume/vol-1234567890abcdef0}} \
--principals {{444455556666}} \
--region {{us-east-1}}
```

`--region` 参数是可选的。如果省略它，则该命令使用默认值 Amazon 您所在的地区 Amazon CLI 配置。

------

有关资源共享的更多信息，请参阅 [创建资源共享](https://docs.amazonaws.cn/ram/latest/userguide/working-with-sharing-create.html) 在 *Amazon RAM 用户指南*。

## 查看共享卷
<a name="view-shared-volumes"></a>

创建资源共享后，指定的账户会收到邀请。组织以外的账户在 Amazon Organizations 他们必须接受邀请才能访问共享卷。有关更多信息，请参阅《Amazon RAM 用户指南》**中的[接受和拒绝资源共享邀请](https://docs.amazonaws.cn/ram/latest/userguide/working-with-shared-create.html)。

您可以使用以下方法之一查看与您的账户共享的卷。

------
#### [ Console ]

**查看共享卷**

1. 在以下位置打开亚马逊弹性计算云控制台 [https://console.amazonaws.cn/ec2/](https://console.amazonaws.cn/ec2/)。

1. 在导航窗格中，选择 **Volumes**。

1. 请执行以下操作之一：
   + 选择 **和我分享了** 预设过滤器以显示与您的账户共享的所有音量。
   + 选择 **添加过滤器**， **所有者 ID**，然后输入共享账户 ID。

共享卷将共享账户 ID 显示在 **所有者 ID** 专栏。

------
#### [ Amazon CLI ]

使用 [描述音量](https://docs.amazonaws.cn/cli/latest/reference/ec2/describe-volumes.html) 使用 `owner-id` 筛选以显示特定账户与您共享的交易量。这个 `--region` 参数是可选的；如果省略该参数，则该命令将使用您的默认区域 Amazon CLI 配置。

```
aws ec2 describe-volumes \
--filters Name=owner-id,Values={{111122223333}} \
--region {{us-east-1}}
```

共享卷包括 `OwnerId` 响应中的字段，显示共享账户 ID。

------

## 共享音量的注意事项
<a name="share-volume-considerations"></a>

与其他账户共享交易量时，请考虑以下几点。
+ 您可以共享未加密的卷和使用客户管理的密钥加密的卷。您无法共享使用默认加密的卷数 Amazon 亚马逊 EBS 的管理密钥。
+ 要共享卷，卷所有者的账户必须有 `kms:DescribeKey` 对默认 Amazon EBS 加密密钥的权限。这是所有卷所必需的，包括未加密的卷，因为该服务会在共享过程中验证卷的加密状态。
+ 要共享使用客户管理密钥加密的卷，您还必须与消费账户共享 KMS 密钥。有关更多信息，请参阅《Amazon Key Management Service 开发人员指南》**中的 [Allowing users in other accounts to use a KMS key](https://docs.amazonaws.cn/kms/latest/developerguide/key-policy-modifying-external-accounts.html)。
+ 要创建共享加密卷的副本，消费账户需要 `kms:CreateGrant`， `kms:GenerateDataKey`， `kms:GenerateDataKeyWithoutPlaintext`， `kms:ReEncrypt*`，以及 `kms:Decrypt` 在 KMS 密钥上。
+ 消费账户无法附加、修改、删除或创建共享卷的快照。他们只能查看卷元数据和创建副本。
+ 在共享卷的所有账户中，一次只能对共享卷进行一次复制操作。在当前操作完成之前，其他复制请求会返回错误。
+ 可用区名称（例如 `us-east-1a`) 映射到不同位置的不同物理位置 Amazon 账户。使用可用区 ID（例如 `use1-az1`) 识别账户间的相同物理位置。有关更多信息，请参阅 [您的可用区 ID Amazon 资源](https://docs.amazonaws.cn/ram/latest/userguide/working-with-az-ids.html) 在 *Amazon RAM 用户指南*。
+ 从资源共享中移除卷并不会取消正在进行的复制操作。
+ 删除源卷不会取消正在进行的复制操作。

## 监控共享活动
<a name="share-volume-monitoring"></a>

### Amazon CloudTrail API 日志
<a name="share-volume-monitoring-cloudtrail"></a>

所有音量共享和复制 API 调用均已登录 Amazon CloudTrail。 `CopyVolumes`系统会记录发起复制的账户和卷所有者的账户的 API 调用。有关更多信息，请参阅 [使用以下方式记录亚马逊弹性计算云 API 调用 Amazon CloudTrail](https://docs.amazonaws.cn/AWSEC2/latest/UserGuide/monitor-with-cloudtrail.html)。

### 亚马逊 EventBridge 通知
<a name="share-volume-monitoring-eventbridge"></a>

亚马逊 EBS 派遣亚马逊 EventBridge 跨账户复制操作完成时发生的事件。批量所有者和消费账户都会收到该事件。批量复制事件使用详细信息类型 `EBS Volume Notification` 使用事件名称 `sharedVolumeCopy`。该事件包括卷 ID、完成状态 (`completed` 要么 `failed`) 和时间戳。

要设置通知，请创建亚马逊 EventBridge 匹配的规则 `EBS Volume Notification` 与... 相关的活动 `sharedVolumeCopy` 事件名称。有关更多信息，请参阅 [亚马逊 EventBridge 亚马逊 EBS 活动](https://docs.amazonaws.cn/ebs/latest/userguide/ebs-cloud-watch-events.html)。

## 共享卷和回收站
<a name="shared-volumes-recycle-bin"></a>

如果您有适用于卷的回收站保留规则，则删除共享卷会将其移至回收站。音量保持在 Amazon RAM 整个保留期内的资源共享。当您从回收站恢复卷时，可以通过删除前所属的相同资源共享来访问该卷。

请注意回收站中卷的以下资源共享行为：
+ 如果您在卷处于回收站时从资源共享中删除了该帐户，则恢复该卷不会重新授予该帐户访问权限。
+ 如果您在卷处于回收站中时向资源共享添加了一个帐户，则该账户在恢复后可以访问该卷。

从回收站还原卷后，通过查看您在回收站中的资源共享来验证只有目标账户才有访问权限 [Amazon RAM 控制台](https://console.amazonaws.cn/ram/)。

## 定价
<a name="share-volume-pricing"></a>

通过以下方式共享音量是免费的 Amazon RAM。创建副本的账户支付批量复制费用和新卷的常规亚马逊 EBS 批量费用。有关更多信息，请参阅 [Amazon EBS 定价](https://www.amazonaws.cn/ebs/pricing/)。