You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.

Class: Aws::IAM::Types::CreateServiceLinkedRoleRequest

Inherits:
Struct
  • Object
show all
Defined in:
(unknown)

Overview

Note:

When passing CreateServiceLinkedRoleRequest as input to an Aws::Client method, you can use a vanilla Hash:

{
  aws_service_name: "groupNameType", # required
  description: "roleDescriptionType",
  custom_suffix: "customSuffixType",
}

See Also:

Instance Attribute Summary collapse

Instance Attribute Details

#aws_service_name ⇒ String

The service principal for the AWS service to which this role is attached. You use a string similar to a URL but without the http:// in front. For example: elasticbeanstalk.amazonaws.com.

Service principals are unique and case-sensitive. To find the exact service principal for your service-linked role, see AWS Services That Work with IAM in the IAM User Guide. Look for the services that have Yes in the Service-Linked Role column. Choose the Yes link to view the service-linked role documentation for that service.

Returns:

  • (String) —

    The service principal for the AWS service to which this role is attached.

#custom_suffix ⇒ String

A string that you provide, which is combined with the service-provided prefix to form the complete role name. If you make multiple requests for the same service, then you must supply a different CustomSuffix for each request. Otherwise the request fails with a duplicate role name error. For example, you could add -1 or -debug to the suffix.

Some services do not support the CustomSuffix parameter. If you provide an optional suffix and the operation fails, try the operation again without the suffix.

Returns:

  • (String) —

    A string that you provide, which is combined with the service-provided prefix to form the complete role name.

#description ⇒ String

The description of the role.

Returns:

  • (String) —

    The description of the role.