libZSservicesZSamazonka-iamZSamazonka-iam
Copyright(c) 2013-2021 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone

Amazonka.IAM.DeleteServiceLinkedRole

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.

Synopsis

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

Read DeleteServiceLinkedRole Source # 
Instance details

Defined in Amazonka.IAM.DeleteServiceLinkedRole

Show DeleteServiceLinkedRole Source # 
Instance details

Defined in Amazonka.IAM.DeleteServiceLinkedRole

Generic DeleteServiceLinkedRole Source # 
Instance details

Defined in Amazonka.IAM.DeleteServiceLinkedRole

Associated Types

type Rep DeleteServiceLinkedRole :: Type -> Type #

NFData DeleteServiceLinkedRole Source # 
Instance details

Defined in Amazonka.IAM.DeleteServiceLinkedRole

Methods

rnf :: DeleteServiceLinkedRole -> () #

Hashable DeleteServiceLinkedRole Source # 
Instance details

Defined in Amazonka.IAM.DeleteServiceLinkedRole

AWSRequest DeleteServiceLinkedRole Source # 
Instance details

Defined in Amazonka.IAM.DeleteServiceLinkedRole

ToHeaders DeleteServiceLinkedRole Source # 
Instance details

Defined in Amazonka.IAM.DeleteServiceLinkedRole

ToPath DeleteServiceLinkedRole Source # 
Instance details

Defined in Amazonka.IAM.DeleteServiceLinkedRole

ToQuery DeleteServiceLinkedRole Source # 
Instance details

Defined in Amazonka.IAM.DeleteServiceLinkedRole

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

newDeleteServiceLinkedRole Source #

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

Read DeleteServiceLinkedRoleResponse Source # 
Instance details

Defined in Amazonka.IAM.DeleteServiceLinkedRole

Show DeleteServiceLinkedRoleResponse Source # 
Instance details

Defined in Amazonka.IAM.DeleteServiceLinkedRole

Generic DeleteServiceLinkedRoleResponse Source # 
Instance details

Defined in Amazonka.IAM.DeleteServiceLinkedRole

Associated Types

type Rep DeleteServiceLinkedRoleResponse :: Type -> Type #

NFData DeleteServiceLinkedRoleResponse Source # 
Instance details

Defined in Amazonka.IAM.DeleteServiceLinkedRole

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 #

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_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>.