Copyright	(c) 2013-2021 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None

Amazonka.IAM.DeleteServiceLinkedRole

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Submits a service-linked role deletion request and returns a DeletionTaskId, which you can use to check the status of the deletion. Before you call this operation, confirm that the role has no active sessions and that any resources used by the role in the linked service are deleted. If you call this operation more than once for the same service-linked role and an earlier deletion task is not complete, then the DeletionTaskId of the earlier request is returned.

If you submit a deletion request for a service-linked role whose linked service is still accessing a resource, then the deletion task fails. If it fails, the GetServiceLinkedRoleDeletionStatus operation returns the reason for the failure, usually including the resources that must be deleted. To delete the service-linked role, you must first remove those resources from the linked service and then submit the deletion request again. Resources are specific to the service that is linked to the role. For more information about removing resources from a service, see the Amazon Web Services documentation for your service.

For more information about service-linked roles, see Roles terms and concepts: Amazon Web Services service-linked role in the IAM User Guide.

Creating a Request

data DeleteServiceLinkedRole Source #

See: newDeleteServiceLinkedRole smart constructor.

Constructors

DeleteServiceLinkedRole'
Fields roleName :: Text The name of the service-linked role to be deleted.

Instances

Instances details

Eq DeleteServiceLinkedRole Source #
Instance details Defined in Amazonka.IAM.DeleteServiceLinkedRole Methods (==) :: DeleteServiceLinkedRole -> DeleteServiceLinkedRole -> Bool # (/=) :: DeleteServiceLinkedRole -> DeleteServiceLinkedRole -> Bool #
Read DeleteServiceLinkedRole Source #
Instance details Defined in Amazonka.IAM.DeleteServiceLinkedRole Methods readsPrec :: Int -> ReadS DeleteServiceLinkedRole # readList :: ReadS [DeleteServiceLinkedRole] # readPrec :: ReadPrec DeleteServiceLinkedRole # readListPrec :: ReadPrec [DeleteServiceLinkedRole] #
Show DeleteServiceLinkedRole Source #
Instance details Defined in Amazonka.IAM.DeleteServiceLinkedRole Methods showsPrec :: Int -> DeleteServiceLinkedRole -> ShowS # show :: DeleteServiceLinkedRole -> String # showList :: [DeleteServiceLinkedRole] -> ShowS #
Generic DeleteServiceLinkedRole Source #
Instance details Defined in Amazonka.IAM.DeleteServiceLinkedRole Associated Types type Rep DeleteServiceLinkedRole :: Type -> Type # Methods from :: DeleteServiceLinkedRole -> Rep DeleteServiceLinkedRole x # to :: Rep DeleteServiceLinkedRole x -> DeleteServiceLinkedRole #
NFData DeleteServiceLinkedRole Source #
Instance details Defined in Amazonka.IAM.DeleteServiceLinkedRole Methods rnf :: DeleteServiceLinkedRole -> () #
Hashable DeleteServiceLinkedRole Source #
Instance details Defined in Amazonka.IAM.DeleteServiceLinkedRole Methods hashWithSalt :: Int -> DeleteServiceLinkedRole -> Int # hash :: DeleteServiceLinkedRole -> Int #
AWSRequest DeleteServiceLinkedRole Source #
Instance details Defined in Amazonka.IAM.DeleteServiceLinkedRole Associated Types type AWSResponse DeleteServiceLinkedRole # Methods request :: DeleteServiceLinkedRole -> Request DeleteServiceLinkedRole # response :: MonadResource m => Logger -> Service -> Proxy DeleteServiceLinkedRole -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse DeleteServiceLinkedRole))) #
ToHeaders DeleteServiceLinkedRole Source #
Instance details Defined in Amazonka.IAM.DeleteServiceLinkedRole Methods toHeaders :: DeleteServiceLinkedRole -> [Header] #
ToPath DeleteServiceLinkedRole Source #
Instance details Defined in Amazonka.IAM.DeleteServiceLinkedRole Methods toPath :: DeleteServiceLinkedRole -> ByteString #
ToQuery DeleteServiceLinkedRole Source #
Instance details Defined in Amazonka.IAM.DeleteServiceLinkedRole Methods toQuery :: DeleteServiceLinkedRole -> QueryString #
type Rep DeleteServiceLinkedRole Source #
Instance details Defined in Amazonka.IAM.DeleteServiceLinkedRole type Rep DeleteServiceLinkedRole = D1 ('MetaData "DeleteServiceLinkedRole" "Amazonka.IAM.DeleteServiceLinkedRole" "libZSservicesZSamazonka-iamZSamazonka-iam" 'False) (C1 ('MetaCons "DeleteServiceLinkedRole'" 'PrefixI 'True) (S1 ('MetaSel ('Just "roleName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))
type AWSResponse DeleteServiceLinkedRole Source #
Instance details Defined in Amazonka.IAM.DeleteServiceLinkedRole type AWSResponse DeleteServiceLinkedRole = DeleteServiceLinkedRoleResponse

newDeleteServiceLinkedRole Source #

Arguments

:: Text	`$sel:roleName:DeleteServiceLinkedRole'`
-> DeleteServiceLinkedRole

Create a value of DeleteServiceLinkedRole with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:roleName:DeleteServiceLinkedRole', deleteServiceLinkedRole_roleName - The name of the service-linked role to be deleted.

Request Lenses

deleteServiceLinkedRole_roleName :: Lens' DeleteServiceLinkedRole Text Source #

The name of the service-linked role to be deleted.

Destructuring the Response

data DeleteServiceLinkedRoleResponse Source #

See: newDeleteServiceLinkedRoleResponse smart constructor.

Constructors

DeleteServiceLinkedRoleResponse'
Fields httpStatus :: Int The response's http status code. deletionTaskId :: Text The deletion task identifier that you can use to check the status of the deletion. This identifier is returned in the format `task/aws-service-role/<service-principal-name>/<role-name>/<task-uuid>`.

Instances

Instances details

Eq DeleteServiceLinkedRoleResponse Source #
Instance details Defined in Amazonka.IAM.DeleteServiceLinkedRole Methods (==) :: DeleteServiceLinkedRoleResponse -> DeleteServiceLinkedRoleResponse -> Bool # (/=) :: DeleteServiceLinkedRoleResponse -> DeleteServiceLinkedRoleResponse -> Bool #
Read DeleteServiceLinkedRoleResponse Source #
Instance details Defined in Amazonka.IAM.DeleteServiceLinkedRole Methods readsPrec :: Int -> ReadS DeleteServiceLinkedRoleResponse # readList :: ReadS [DeleteServiceLinkedRoleResponse] # readPrec :: ReadPrec DeleteServiceLinkedRoleResponse # readListPrec :: ReadPrec [DeleteServiceLinkedRoleResponse] #
Show DeleteServiceLinkedRoleResponse Source #
Instance details Defined in Amazonka.IAM.DeleteServiceLinkedRole Methods showsPrec :: Int -> DeleteServiceLinkedRoleResponse -> ShowS # show :: DeleteServiceLinkedRoleResponse -> String # showList :: [DeleteServiceLinkedRoleResponse] -> ShowS #
Generic DeleteServiceLinkedRoleResponse Source #
Instance details Defined in Amazonka.IAM.DeleteServiceLinkedRole Associated Types type Rep DeleteServiceLinkedRoleResponse :: Type -> Type # Methods from :: DeleteServiceLinkedRoleResponse -> Rep DeleteServiceLinkedRoleResponse x # to :: Rep DeleteServiceLinkedRoleResponse x -> DeleteServiceLinkedRoleResponse #
NFData DeleteServiceLinkedRoleResponse Source #
Instance details Defined in Amazonka.IAM.DeleteServiceLinkedRole Methods rnf :: DeleteServiceLinkedRoleResponse -> () #
type Rep DeleteServiceLinkedRoleResponse Source #
Instance details Defined in Amazonka.IAM.DeleteServiceLinkedRole type Rep DeleteServiceLinkedRoleResponse = D1 ('MetaData "DeleteServiceLinkedRoleResponse" "Amazonka.IAM.DeleteServiceLinkedRole" "libZSservicesZSamazonka-iamZSamazonka-iam" 'False) (C1 ('MetaCons "DeleteServiceLinkedRoleResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int) :*: S1 ('MetaSel ('Just "deletionTaskId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))

newDeleteServiceLinkedRoleResponse Source #

Arguments

:: Int	`$sel:httpStatus:DeleteServiceLinkedRoleResponse'`
-> Text	`$sel:deletionTaskId:DeleteServiceLinkedRoleResponse'`
-> DeleteServiceLinkedRoleResponse

Create a value of DeleteServiceLinkedRoleResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:httpStatus:DeleteServiceLinkedRoleResponse', deleteServiceLinkedRoleResponse_httpStatus - The response's http status code.

$sel:deletionTaskId:DeleteServiceLinkedRoleResponse', deleteServiceLinkedRoleResponse_deletionTaskId - The deletion task identifier that you can use to check the status of the deletion. This identifier is returned in the format task/aws-service-role/<service-principal-name>/<role-name>/<task-uuid>.

Response Lenses

deleteServiceLinkedRoleResponse_httpStatus :: Lens' DeleteServiceLinkedRoleResponse Int Source #

The response's http status code.

deleteServiceLinkedRoleResponse_deletionTaskId :: Lens' DeleteServiceLinkedRoleResponse Text Source #

The deletion task identifier that you can use to check the status of the deletion. This identifier is returned in the format task/aws-service-role/<service-principal-name>/<role-name>/<task-uuid>.