Skip to main content

service_linked_role

Gets or updates an individual service_linked_role resource, use service_linked_roles to retrieve a list of resources or to create or delete a resource.

Overview

Nameservice_linked_role
TypeResource
DescriptionResource Type definition for AWS::IAM::ServiceLinkedRole
Idaws.iam.service_linked_role

Fields

NameDatatypeDescription
role_namestringThe name of the role.
custom_suffixstringA string that you provide, which is combined with the service-provided prefix to form the complete role name.
descriptionstringThe description of the role.
aws_service_namestringThe service principal for the AWS service to which this role is attached.
regionstringAWS region.

Methods

NameAccessible byRequired Params
update_resourceUPDATEdata__Identifier, data__PatchDocument, region
get_resourceSELECTdata__Identifier, region

SELECT Example

SELECT
region,
role_name,
custom_suffix,
description,
aws_service_name
FROM aws.iam.service_linked_role
WHERE data__Identifier = '<RoleName>';

Permissions

To operate on the service_linked_role resource, the following permissions are required:

Read

iam:GetRole

Update

iam:UpdateRole,
iam:GetRole