使用配置传送状态日志 Amazon SDKs - Amazon Simple Notification Service
主题属性
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

使用配置传送状态日志 Amazon SDKs

Amazon SDKs 提供了多种 APIs 语言来设置消息传送状态记录的主题属性。例如，使用 SetTopicAttributesAPI 来配置：

  • LambdaSuccessFeedbackRoleArn – 向 Lambda 端点传输成功消息的 IAM 角色。

  • LambdaSuccessFeedbackSampleRate – 传输到 Lambda 端点的成功消息采样率。

  • LambdaFailureFeedbackRoleArn – 向 Lambda 端点传输失败消息的 IAM 角色。

Amazon CLI 命令示例

aws sns set-topic-attributes \
    --topic-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
    --attribute-name LambdaSuccessFeedbackRoleArn \
    --attribute-value arn:aws:iam::123456789012:role/MyFeedbackRole

主题属性

对消息传输状态使用下列主题属性名称值：

HTTP

  • HTTPSuccessFeedbackRoleArn – 订阅到 HTTP 端点的 Amazon SNS 主题的成功消息传输状态。

  • HTTPSuccessFeedbackSampleRate – 订阅到 HTTP 端点的 Amazon SNS 主题的成功消息采样百分比。

  • HTTPFailureFeedbackRoleArn – 订阅到 HTTP 端点的 Amazon SNS 主题的失败消息传输状态。

Amazon Data Firehose

  • FirehoseSuccessFeedbackRoleArn – 订阅到 Amazon Data Firehose 端点的 Amazon SNS 主题的成功消息传输状态。

  • FirehoseSuccessFeedbackSampleRate – 订阅到 Amazon Data Firehose 端点的 Amazon SNS 主题的成功消息采样百分比。

  • FirehoseFailureFeedbackRoleArn – 订阅到 Amazon Data Firehose 端点的 Amazon SNS 主题的失败消息传输状态。

Amazon Lambda

  • LambdaSuccessFeedbackRoleArn – 订阅到 Lambda 端点的 Amazon SNS 主题的成功消息传输状态。

  • LambdaSuccessFeedbackSampleRate – 订阅到 Lambda 端点的 Amazon SNS 主题的成功消息采样百分比。

  • LambdaFailureFeedbackRoleArn – 订阅到 Lambda 端点的 Amazon SNS 主题的失败消息传输状态。

平台应用程序端点

  • ApplicationSuccessFeedbackRoleArn— 订阅应用程序终端节点的 Amazon SNS 主题的成功消息传输状态。 Amazon

  • ApplicationSuccessFeedbackSampleRate – 订阅到 Amazon 应用程序端点的 Amazon SNS 主题的成功消息采样百分比。

  • ApplicationFailureFeedbackRoleArn— 订阅应用程序终端节点的 Amazon SNS 主题的消息传输失败状态。 Amazon

    注意

    此外，您还可以配置应用程序属性，直接将传输状态记录到推送通知服务中。有关更多信息，请参阅使用用于消息传输状态的 Amazon SNS 应用程序属性。

Amazon SQS

  • SQSSuccessFeedbackRoleArn – 订阅到 Amazon SQS 端点的 Amazon SNS 主题的成功消息传输状态。

  • SQSSuccessFeedbackSampleRate – 订阅到 Amazon SQS 端点的 Amazon SNS 主题的成功消息采样百分比。

  • SQSFailureFeedbackRoleArn – 订阅到 Amazon SQS 端点的 Amazon SNS 主题的失败消息传输状态。

平台应用程序终端节点的日志与其他终端节点一样写入同一个 CloudWatch 日志组。

注意

<ENDPOINT>SuccessFeedbackRoleArn和<ENDPOINT>FailureFeedbackRoleArn属性用于向 Amazon SNS 授予代表您使用 CloudWatch 日志的写入权限。<ENDPOINT>SuccessFeedbackSampleRate 属性用于指定成功传输消息的采样率百分比 (0-100)。配置该<ENDPOINT>FailureFeedbackRoleArn属性后，所有失败的消息传送都会生成 CloudWatch 日志。