APIGatewayServiceRolePolicy

OperatorService-linked roleActivePermissions reviewedShow on map Compare

Summary

Allows API Gateway to manage associated AWS Resources on behalf of the customer.

Permissions imported from the AWS Managed Policy Reference Guide; other sections pending editorial review.

Identity

ARN: arn:aws:iam::aws:policy/aws-service-role/APIGatewayServiceRolePolicy
Default version: v9
Created: 2017-10-20
Last edited: 2021-07-12
Services: acm, ec2, elasticloadbalancing, firehose, logs, servicediscovery, xray

Control-plane actions (32)

By access level: 10 List, 2 Permissions management, 8 Read, 1 Tagging, 11 Write.

Control-plane actions by service
Service	Granted	Access levels and limits	Granted by
Certificate Manager	2 of 42	2 Read; 2 restricted, 0 conditional	acm:DescribeCertificate, acm:GetCertificate
EC2	16 of 834	8 List, 2 Permissions management, 1 Tagging, 5 Write; 2 restricted, 1 conditional	ec2:AssignPrivateIpAddresses, ec2:CreateNetworkInterface, ec2:CreateNetworkInterfacePermission, ec2:CreateTags, ec2:DeleteNetworkInterface, ec2:DeleteNetworkInterfacePermission, ec2:DescribeAvailabilityZones, ec2:DescribeNetworkInterfaceAttribute, ec2:DescribeNetworkInterfacePermissions, ec2:DescribeNetworkInterfaces, ec2:DescribeRouteTables, ec2:DescribeSecurityGroups and 4 more
ELB	5 of 77	1 List, 1 Read, 3 Write; 0 restricted, 0 conditional	elasticloadbalancing:AddListenerCertificates, elasticloadbalancing:DescribeListeners, elasticloadbalancing:DescribeLoadBalancers, elasticloadbalancing:ModifyListener, elasticloadbalancing:RemoveListenerCertificates
Firehose	1 of 10	1 Read; 1 restricted, 0 conditional	firehose:DescribeDeliveryStream
CloudWatch Logs	5 of 133	1 List, 1 Read, 3 Write; 0 restricted, 0 conditional	logs:CreateLogDelivery, logs:DeleteLogDelivery, logs:GetLogDelivery, logs:ListLogDeliveries, logs:UpdateLogDelivery
Cloud Map	2 of 31	2 Read; 2 restricted, 0 conditional	servicediscovery:GetNamespace, servicediscovery:GetService
X-Ray	1 of 32	1 Read; 0 restricted, 0 conditional	xray:GetSamplingRules

Certificate Manager: 2 actions

acm:DescribeCertificate (Read)
acm:GetCertificate (Read)

EC2: 16 actions

ec2:AssignPrivateIpAddresses (Write)
ec2:CreateNetworkInterface (Write)
ec2:CreateNetworkInterfacePermission (Permissions management)
ec2:CreateTags (Tagging)
ec2:DeleteNetworkInterface (Write)
ec2:DeleteNetworkInterfacePermission (Permissions management)
ec2:DescribeAvailabilityZones (List)
ec2:DescribeNetworkInterfaceAttribute (List)
ec2:DescribeNetworkInterfacePermissions (List)
ec2:DescribeNetworkInterfaces (List)
ec2:DescribeRouteTables (List)
ec2:DescribeSecurityGroups (List)
ec2:DescribeSubnets (List)
ec2:DescribeVpcs (List)
ec2:ModifyNetworkInterfaceAttribute (Write)
ec2:UnassignPrivateIpAddresses (Write)

ELB: 5 actions

elasticloadbalancing:AddListenerCertificates (Write)
elasticloadbalancing:DescribeListeners (Read)
elasticloadbalancing:DescribeLoadBalancers (List)
elasticloadbalancing:ModifyListener (Write)
elasticloadbalancing:RemoveListenerCertificates (Write)

Firehose: 1 actions

firehose:DescribeDeliveryStream (Read)

CloudWatch Logs: 5 actions

logs:CreateLogDelivery (Write)
logs:DeleteLogDelivery (Write)
logs:GetLogDelivery (Read)
logs:ListLogDeliveries (List)
logs:UpdateLogDelivery (Write)

Cloud Map: 2 actions

servicediscovery:GetNamespace (Read)
servicediscovery:GetService (Read)

X-Ray: 1 actions

xray:GetSamplingRules (Read)

Data-plane actions (6)

By access level: 2 Read, 4 Write.

Data-plane actions by service
Service	Granted	Access levels and limits	Granted by
Firehose	All 2 actions (see the Firehose page)	2 Write; 2 restricted, 0 conditional	firehose:PutRecord, firehose:PutRecordBatch
Cloud Map	1 of 2	1 Read; 0 restricted, 0 conditional	servicediscovery:DiscoverInstances
X-Ray	3 of 12	1 Read, 2 Write; 0 restricted, 0 conditional	xray:GetSamplingTargets, xray:PutTelemetryRecords, xray:PutTraceSegments

Cloud Map: 1 actions

servicediscovery:DiscoverInstances (Read)

X-Ray: 3 actions

xray:GetSamplingTargets (Read)
xray:PutTelemetryRecords (Write)
xray:PutTraceSegments (Write)

Excluded and conditional actions

No patterns are excluded by NotAction or Deny statements.

Resource scope and attachment

Resource scope across granted actions: mixed.

Can be attached: No (service-linked role policy).

Why this tier

Grants 18 write, tagging or permissions-management actions, short of full control of any service.

Guidance

Pending editorial review. The permission data on this page comes straight from AWS; this section will be filled in once a reviewed guide exists.

Same service

Same domain

Frequently asked questions

Pending editorial review. The permission data on this page comes straight from AWS; this section will be filled in once a reviewed guide exists.

Policy JSON

Download policy.json

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "elasticloadbalancing:AddListenerCertificates",
        "elasticloadbalancing:RemoveListenerCertificates",
        "elasticloadbalancing:ModifyListener",
        "elasticloadbalancing:DescribeListeners",
        "elasticloadbalancing:DescribeLoadBalancers",
        "xray:PutTraceSegments",
        "xray:PutTelemetryRecords",
        "xray:GetSamplingTargets",
        "xray:GetSamplingRules",
        "logs:CreateLogDelivery",
        "logs:GetLogDelivery",
        "logs:UpdateLogDelivery",
        "logs:DeleteLogDelivery",
        "logs:ListLogDeliveries",
        "servicediscovery:DiscoverInstances"
      ],
      "Resource": [
        "*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "firehose:DescribeDeliveryStream",
        "firehose:PutRecord",
        "firehose:PutRecordBatch"
      ],
      "Resource": "arn:aws:firehose:*:*:deliverystream/amazon-apigateway-*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "acm:DescribeCertificate",
        "acm:GetCertificate"
      ],
      "Resource": "arn:aws:acm:*:*:certificate/*"
    },
    {
      "Effect": "Allow",
      "Action": "ec2:CreateNetworkInterfacePermission",
      "Resource": "arn:aws:ec2:*:*:network-interface/*"
    },
    {
      "Effect": "Allow",
      "Action": "ec2:CreateTags",
      "Resource": "arn:aws:ec2:*:*:network-interface/*",
      "Condition": {
        "ForAllValues:StringEquals": {
          "aws:TagKeys": [
            "Owner",
            "VpcLinkId"
          ]
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "ec2:ModifyNetworkInterfaceAttribute",
        "ec2:DeleteNetworkInterface",
        "ec2:AssignPrivateIpAddresses",
        "ec2:CreateNetworkInterface",
        "ec2:DeleteNetworkInterfacePermission",
        "ec2:DescribeNetworkInterfaces",
        "ec2:DescribeAvailabilityZones",
        "ec2:DescribeNetworkInterfaceAttribute",
        "ec2:DescribeVpcs",
        "ec2:DescribeNetworkInterfacePermissions",
        "ec2:UnassignPrivateIpAddresses",
        "ec2:DescribeSubnets",
        "ec2:DescribeRouteTables",
        "ec2:DescribeSecurityGroups"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": "servicediscovery:GetNamespace",
      "Resource": "arn:aws:servicediscovery:*:*:namespace/*"
    },
    {
      "Effect": "Allow",
      "Action": "servicediscovery:GetService",
      "Resource": "arn:aws:servicediscovery:*:*:service/*"
    }
  ]
}

Version history

Current version v9, edited by AWS on 2021-07-12. Version history is recorded from 2026-11-11. Earlier versions are in the IAM console under Policy versions.

Attach snippets

This policy cannot be attached to users, groups or roles, so there are no attach snippets.

Sources

Pending editorial review. No editorial sources are listed yet.