Amazon Virtual Private Cloud
Transit Gateways

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

Transit Gateway Service-Linked Role

Amazon VPC uses service-linked roles for the permissions that it requires to call other AWS services on your behalf. For more information, see Using Service-Linked Roles in the IAM User Guide.

Permissions Granted by the Service-Linked Role

Amazon VPC uses the service-linked role named AWSServiceRoleForVPCTransitGateway to call the following actions on your behalf when you work with a transit gateway:

  • ec2:CreateNetworkInterface

  • ec2:DescribeNetworkInterface

  • ec2:ModifyNetworkInterfaceAttribute

  • ec2:DeleteNetworkInterface

  • ec2:CreateNetworkInterfacePermission

AWSServiceRoleForVPCTransitGateway trusts the service to assume the role.

Create the Service-Linked Role

You don't need to manually create the AWSServiceRoleForVPCTransitGateway role. Amazon VPC creates this role for you when you attach a VPC in your account to a transit gateway.

For Amazon VPC to create a service-linked role on your behalf, you must have the required permissions. For more information, see Service-Linked Role Permissions in the IAM User Guide.

Edit the Service-Linked Role

You can edit the description of AWSServiceRoleForVPCTransitGateway using IAM. For more information, see Editing a Service-Linked Role in the IAM User Guide.

Delete the Service-Linked Role

If you no longer need to use transit gateways, we recommend that you delete AWSServiceRoleForVPCTransitGateway.

You can delete this service-linked role only after you delete all transit gateway VPC attachments in your AWS account. This ensures that you can't inadvertently remove permission to access your VPC attachments.

You can use the IAM console, the IAM CLI, or the IAM API to delete service-linked roles. For more information, see Deleting a Service-Linked Role in the IAM User Guide.

After you delete AWSServiceRoleForVPCTransitGateway, Amazon VPC creates the role again if you attach a VPC in your account to a transit gateway.