# 将 EventBridge 用于 Outposts 上的 S3 复制
<a name="outposts-replication-eventbridge"></a>

Amazon S3 on Outposts 已与 Amazon EventBridge 集成，并使用 `s3-outposts` 命名空间。EventBridge 是一种无服务器事件总线服务，您可以使用它将应用程序与来自各种来源的数据相连接。有关更多信息，请参阅 *Amazon EventBridge 用户指南*中的[什么是 Amazon EventBridge？](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-what-is.html)。

为了帮助解决任何复制配置问题，您可以设置 Amazon EventBridge 来接收有关复制失败事件的通知。在对象未复制到其目标 Outposts 的情况下，EventBridge 可以通知您。有关正在复制的对象的当前状态的更多信息，请参阅[复制状态概述](manage-outposts-replication.md#outposts-replication-status-overview)。

每当 Outposts 桶中发生某些事件时，S3 on Outposts 都可以将事件发送到 EventBridge。与其他目标不同，您无需选择要提供的事件类型。还可以使用 EventBridge 规则将事件路由到其他目标。启用 EventBridge 后，S3 on Outposts 会将以下所有事件发送到 EventBridge。


| Event type | 说明  | 命名空间 | 
| --- | --- | --- | 
| `OperationFailedReplication` | 复制规则内的对象复制已失败。有关 Outposts 上的 S3 复制失败原因的更多信息，请参阅[使用 EventBridge 查看 Outposts 上的 S3 复制失败原因](#outposts-replication-failure-codes)。 | `s3-outposts` | 

## 使用 EventBridge 查看 Outposts 上的 S3 复制失败原因
<a name="outposts-replication-failure-codes"></a>

下表列出了 Outposts 上的 S3 复制失败原因。您可以将 EventBridge 规则配置为通过 Amazon Simple Queue Service（Amazon SQS）、Amazon Simple Notification Service（Amazon SNS）、Amazon Lambda 或 Amazon CloudWatch Logs 发布和查看失败原因。有关将这些资源用于 EventBridge 所需权限的更多信息，请参阅[将基于资源的策略用于 EventBridge](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-use-resource-based.html)。


| 复制失败原因 | 说明 | 
| --- | --- | 
| AssumeRoleNotPermitted | S3 on Outposts 无法代入在复制配置中指定的 Amazon Identity and Access Management（IAM）角色。 | 
| DstBucketNotFound | S3 on Outposts 找不到在复制配置中指定的目标桶。 | 
| DstBucketUnversioned | 未在 Outposts 目标桶上启用版本控制。要使用 Outposts 上的 S3 复制来复制对象，必须在目标桶上启用版本控制。 | 
| DstDelObjNotPermitted | S3 on Outposts 无法将删除操作复制到目标桶。针对目标桶的 s3-outposts:ReplicateDelete 权限可能缺失。 | 
| DstMultipartCompleteNotPermitted | S3 on Outposts 无法在目标桶中完成对象的分段上传。针对目标桶的 s3-outposts:ReplicateObject 权限可能缺失。 | 
| DstMultipartInitNotPermitted | S3 on Outposts 无法启动将对象分段上传到目标桶。针对目标桶的 s3-outposts:ReplicateObject 权限可能缺失。 | 
| DstMultipartPartUploadNotPermitted | S3 on Outposts 无法在目标存储桶中上传分段上传对象。针对目标桶的 s3-outposts:ReplicateObject 权限可能缺失。 | 
| DstOutOfCapacity | 因为目标 Outpost 的 S3 存储容量不足，所以 S3 on Outposts 无法复制到此 Outpost。 | 
| DstPutObjNotPermitted | S3 on Outposts 无法将对象复制到目标桶。针对目标桶的 s3-outposts:ReplicateObject 权限可能缺失。 | 
| DstPutTaggingNotPermitted | S3 on Outposts 无法将对象标签复制到目标桶。针对目标桶的 s3-outposts:ReplicateObject 权限可能缺失。 | 
| DstVersionNotFound | S3 on Outposts 无法在目标桶中找到所需的对象版本，从而无法复制该对象版本的元数据。 | 
| SrcBucketReplicationConfigMissing | S3 on Outposts 找不到与源 Outposts 桶关联的接入点的复制配置。 | 
| SrcGetObjNotPermitted | S3 on Outposts 无法访问源桶中的对象来进行复制。针对源桶的 s3-outposts:GetObjectVersionForReplication 权限可能缺失。 | 
| SrcGetTaggingNotPermitted | S3 on Outposts 无法访问源桶中的对象标签信息。针对源桶的 s3-outposts:GetObjectVersionTagging 权限可能缺失。 | 
| SrcHeadObjectNotPermitted | S3 on Outposts 无法从源桶检索对象元数据。针对源桶的 s3-outposts:GetObjectVersionForReplication 权限可能缺失。 | 
| SrcObjectNotEligible | 对象不符合复制条件。对象或其对象标签与复制配置不匹配。 | 

有关排查复制问题的更多信息，请参阅以下主题：
+ [创建 IAM 角色](outposts-replication-prerequisites-config.md#outposts-rep-pretwo)
+ [对复制进行问题排查](manage-outposts-replication.md#outposts-replication-troubleshoot)

## 使用 CloudWatch 监控 EventBridge
<a name="outposts-replication-eventbridge-cw"></a>

为进行监控，Amazon EventBridge 与 Amazon CloudWatch 相集成。EventBridge 会自动每分钟向 CloudWatch 发送指标。这些指标包括[规则](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-rules.html)匹配的[事件](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-events.html)数以及规则调用[目标](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-targets.html)的次数。当规则在 EventBridge 中运行时，将调用与该规则关联的所有目标。您可以按照以下方式通过 CloudWatch 监控 EventBridge 行为。
+ 您可以从 CloudWatch 控制面板监控 EventBridge 规则的可用 [EventBridge 指标](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-monitoring.html#eb-metrics)。然后，您可以使用 CloudWatch 功能（例如 CloudWatch 告警）对某些指标设置告警。如果这些指标达到您在告警中指定的自定义阈值，您将收到通知并可以相应地采取措施。
+ 可以将 Amazon CloudWatch Logs 设置为 EventBridge 规则的目标。然后，EventBridge 创建日志流，而 CloudWatch Logs 将事件中的文本存储为日志条目。有关更多信息，请参阅 [EventBridge 和 CloudWatch Logs](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-use-resource-based.html#eb-cloudwatchlogs-permissions)。

有关调试 EventBridge 事件交付和存档事件的更多信息，请参阅以下主题：
+ [事件重试策略和使用死信队列](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-rule-dlq.html)
+ [存档 EventBridge 事件](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-archive-event.html)