设置通知 - Amazon WorkDocs

注意：亚马逊 WorkDocs不再提供新买家注册和账户升级服务。在此处了解迁移步骤：如何从中迁移数据 WorkDocs。

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

设置通知

您可以按照以下过程设置通知：

  1. 设置 IAM 用户或角色权限以允许来电者访问通知订阅管理 APIs。

  2. 调用通知订阅 APIs 以启用或禁用向您的终端节点发布 SNS 消息。

注意

为了提高安全性，请尽可能创建联合用户而不是 IAM 用户。

设置 IAM 用户权限

  • 使用 IAM 控制台为用户设置以下权限：

    {
    "Version": "2012-10-17",
    "Statement": [
        {
        "Effect": "Allow",
        "Action": [
            "workdocs:CreateNotificationSubscription",
            "workdocs:DeleteNotificationSubscription",
            "workdocs:DescribeNotificationSubscriptions"
            ],
        "Resource": "*"
        }
    ]
}
启用通知

启用通知允许您在订阅通知CreateNotificationSubscription后拨打电话。

  1. 打开 WorkDocs 控制台，网址为https://console.aws.amazon.com/zocalo/。

  2. 在 “管理您的 WorkDocs 网站” 页面上，选择所需的目录，然后选择 “操作”，然后选择 “管理通知”。

  3. 在管理通知页面上，选择启用通知。

  4. 输入您想要允许接收来自您 WorkDocs 网站的通知的用户或角色的 ARN。

有关启用通知功能的信息，请参阅 WorkDocs 将亚马逊 WorkDocs API 与适用于 Python 和 AWS Lambda 的 AWS 开发工具包配合使用。启用通知后，您和您的用户即可订阅通知。

订阅 WorkDocs 通知

  1. 准备端点以处理 Amazon SNS 消息。有关更多信息，请参阅《Amazon 简单通知服务开发者指南》中的 HTTP/S 终端节点扇出。

    重要

    SNS 会向您配置的端点发送确认消息。您必须确认此消息才能收到通知。另外，如果在通过命令行界面或 API 访问 AWS 时需要经过 FIPS 140-2 验证的加密模块，请使用 FIPS 端点。有关可用的 FIPS 端点的更多信息，请参阅《美国联邦信息处理标准（FIPS）第 140-2 版》。

  2. 执行以下操作：

    • 获取组织 ID

      1. 在 AWS Directory Service 控制台导航窗格中，选择目录。

      2. 与您的 Amazon WorkDocs 网站对应的目录 ID 也可用作该网站的组织 ID。

    • 如下所示创建订阅请求：

      CreateNotificationSubscriptionRequest request = new CreateNotificationSubscriptionRequest();
request.setOrganizationId("d-1234567890");
request.setProtocol(SubscriptionProtocolType.Https);
request.setEndpoint("https://my-webhook-service.com/webhook");
request.setSubscriptionType(SubscriptionType.ALL);
CreateNotificationSubscriptionResult result = amazonWorkDocsClient.createNotificationSubscription(request);
System.out.println("WorkDocs notifications subscription-id: " result.getSubscription().getSubscriptionId());

SNS 通知

消息包含以下信息：

  • organizationId – 组织的 ID。

  • parentEntityType – 父级的类型 (Document | DocumentVersion | Folder)。

  • parentEntityId – 父级的 ID。

  • entityType – 实体的类型 (Document | DocumentVersion | Folder)。

  • entityId – 实体的 ID。

  • 操作 – 操作，可以为以下值之一：

    • delete_document

    • move_document

    • recycle_document

    • rename_document

    • revoke_share_document

    • share_document

    • upload_document_version

禁用通知

  1. 打开 WorkDocs 控制台，网址为https://console.aws.amazon.com/zocalo/。

  2. 在 “管理您的 WorkDocs 网站” 页面上，选择所需的目录，然后选择 “操作”，然后选择 “管理通知”。

  3. 在管理通知页面上，选择您希望对其禁用通知的 ARN，然后选择禁用通知。