You need to enable JavaScript to run this app. CloudFormation创建跨栈日志投递用IAM角色时报PolicyDocument需为对象错误
优惠活动
大模型
产品
解决方案
定价
更多

CloudFormation创建跨栈日志投递用IAM角色时报PolicyDocument需为对象错误

CloudFormation IAM角色PolicyDocument配置报错修复

报错场景

我正在创建IAM角色,用于将当前CloudFormation栈的日志投递至另一栈的Kinesis流中,添加权限策略时部署失败,控制台抛出校验错误:

“PolicyDocument属性值必须为对象”

存在问题的模板片段

KinesisRole:
  Type: AWS::IAM::Role
  Properties:
    RoleName: {'Fn::Sub': 'Kinesis-Role-${AWS::Region}'}
    AssumeRolePolicyDocument:
      Statement:
      - Effect: Allow
        Principal:
          Service: [logs.amazonaws.com]
        Action: ['sts:AssumeRole']
    Policies:
    - PolicyName: KinesisPolicy
      PolicyDocument:
      - Version: '2017-10-17'
        Statement:
        - Action: ['kinesis:PutRecord']
          Effect: Allow
          Resource: '*'

问题根源

报错本质是*PolicyDocument的结构不符合IAM规范*:
IAM要求PolicyDocument必须是标准对象结构,不能定义为数组。当前配置在PolicyDocument字段下错误添加了列表项前缀-,把原本应该是键值对的嵌套结构变成了数组,触发格式校验失败。

修正后的可用配置

只需要移除PolicyDocument下错误的列表短横线,让Version、Statement作为对象的一级子键存在即可,修正后的配置如下:

KinesisRole:
  Type: AWS::IAM::Role
  Properties:
    RoleName: !Sub 'Kinesis-Role-${AWS::Region}'
    AssumeRolePolicyDocument:
      Version: '2012-10-17'
      Statement:
      - Effect: Allow
        Principal:
          Service:
            - logs.amazonaws.com
        Action:
          - sts:AssumeRole
    Policies:
    - PolicyName: KinesisPolicy
      PolicyDocument:
        Version: '2017-10-17'
        Statement:
        - Action:
            - kinesis:PutRecord
          Effect: Allow
          # 不建议直接配置Resource为*,跨栈场景下建议引用目标栈导出的Kinesis流实际ARN
          Resource: !ImportValue '目标栈Kinesis流ARN的导出键名'

补充优化提示

  • 原配置的AssumeRolePolicyDocument缺少标准的Version声明,补上2012-10-17的策略版本号,可以避免部分区域的兼容问题
  • 跨栈日志投递场景下,不要给kinesis:PutRecord权限直接配置通配资源,通过!ImportValue引用目标栈导出的流ARN,能满足最小权限安全要求

内容的提问来源于stack exchange,提问作者Tisha

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.03 23:27:02